4) BUY IN PRINT WORLOWIDE MAGPI.CC/STORE 


Se ete 











Issue105 | May 2021 | magpicc - The official Raspberry Pi magazine 
Sr RASPBERRY PI 
Code eae 
q Pico Sf. p | | gq 
, | e}e)ade]a)[=} 


ze) 0) [=laas 








SS : 

2 — ESE 
3 < T ARE azo 
The best of <== SECRETS fea @® 


—~—ouT fe) 3 THIS WORLD... 


91 PAGES OF PROJECTS & TUTORIALS 





SHIPPING 


0800 587 0991 
DIGIKEY.CO.UK 


10 MILLION+ PRODUCTS ONLINE | 1,300+ INDUSTRY-LEADING SUPPLIERS | 100% FRANCHISED DISTRIBUTOR 






*A shipping charge of £12.00 will be billed on all orders of less than £33.00. A shipping charge of $18.00 USD will be billed on all orders of less than $50.00 USD. All orders are shipped 
via UPS, Federal Express, or DHL for delivery within 1-3 days (dependent on final destination). No handling fees. All prices are in British pound sterling or United States dollar. Digi-Key 
is a franchised distributor for all supplier partners. New products added daily. Digi-Key and Digi-Key Electronics are registered trademarks of Digi-Key Electronics in the U.S. and other 


countries. © 2021 Digi-Key Electronics, 701 Brooks Ave. South, Thief River Falls, MN 56701, USA 
oe 
D> ECIA MEMBER 


Supporting The Authorized Channel 


WELCOME 
to The MagP1 105 


here’s so much to Raspberry Pi that even we, after years of 
T hacking, making, building and rebuilding, have something 

new to learn. | just learned, after all these years, that holding 
down ALT lets me move windows around in Raspberry Pi OS. 

Our 50 Hacks & Hints feature (page 32) is packed with advice. 
Some of it will be invaluable to absolute beginners; other tips will be 
hidden to even seasoned experts. 

Meanwhile, this year’s #MonthOfMaking has come to a close, and 
Rob has the best of everything that our readers made during March 
(page 72). It’s an amazing collection that showcases the ingenuity of 
the Raspberry Pi community. 

There are a lot of video game builds to enjoy in this issue. KG’s 
amazing arcade machine (page 42) is starting to take shape and 
looks incredible. And one reader has recreated the Star Wars Arcade 
Cabinet from 1983. Plus, if you are into coding there are some 
incredible tutorials this month, from making a tic-tac-toe GUI 
game, to building a Raspberry PI Pico reaction game. 

Ive loved putting together this 


eS 
edition of The MagPi. j se § dA 


) 
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Lucy Hattersley Editor 
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Lucy 
Hattersley 





Lucy has 
rediscovered her 
love of camping this 
year. The trick is to 
buy the bounciest 
inflatable mattress 
you can find. 


@LucyHattersley 
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The simplest shel to o get 
started with the Raspberr 


Everything you need to power up your srajeees is pre-installed in 
this rugged case, including the Raspberry Pi 4 itself. 


With the modular pi-top [4] computer you can create anything from a musical 


instrument to the ultimate alarm system. Explore our online project library to 
learn to code and control your creations. 


We make the future. 


Gain skills for the future 
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ONLINE COURSE 


Learn how to program the game 
you love to play every day. 


ONLINE COURSE 
Coding Music 
with pi-top [4] 


Learn to program your very own 
music Synth using Sonic Pi. 
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courses. You'll be guided by pi-top Certified Trainers, chosen from top universities. 








* Perfect for ages 11-17 
* Beginner to intermediate level 


* 12 one-to-one lessons booked at your convenience 
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Raspberry Pi is a trademark of the Raspberry Pi Foundation. Minecraft is a trademark of Mojang Synergies AB. pi-top is not affiliated with Mojang in any way. © CEED Ltd. 2021 
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<4 The communicator 
uses a series of buttons 
and lights that allow 
Raspberry Pi and VEX 
to communicate 


Seedling Nurturer 


When you need to automate plant watering, you could build your own system 
- or, dS Rob Zwetsloot finds out, use a programmable robot toy 








his month we have a slightly new take of day. I wondered if I could use a Raspberry Pi 
T on automated plant watering, as created with a real-time clock to trigger the mechanism. 
by Engineering Girl, aka Chloe Alfonso. Raspberry Pi would open up many other 
Instead of custom-building a system or hooking possibilities, like accessing the mechanism via 
up prosumer-grade plant care stuff toa Raspberry the web or recording data points (temperature, 
Pi, she’s built a VEX IQ robot system — a kind of humidity, growth) for later comparison.” 
programmable construction block robot — that is 
powered by Raspberry Pi. Ideas on ideas 
Chloe Alfonso “This specific robot allows Raspberry Pi to Just using a Raspberry Pi as a timer, though, is 
A reeshael communicate with the VEX IQ system to create a a bit overpowered, but the possibilities of what 
student who loves plant watering and lighting system,” Chloe tells could be done with it sparked new ideas. 
tinkering, writing, us. “I was trying to raise seedlings and found “Initially, the goal was to water seedlings 
and playing water that sometimes I would forget to water the plants automatically,” Chloe reveals. “However, as the 
polo. She's been F F : : é 
using robotics with or turn on the grow light. I thought it would be idea formed, other benefits of using a Raspberry 
VEX for years. useful to automate the project. VEX — with its Pi arose. From an educational standpoint, I 
magpi.cc/seedling motors, sensors, and Lego-like parts - lends learned how to wire a breadboard, an LED light, 
itself to making structures. However, there is and a button. Learning to do these tasks witha 
no internal mechanism for monitoring the time Raspberry Pi was rewarding in itself, but applying 
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While the main purpose of 
Raspberry Pi is to check the 
time, it can do a lot more with 
sensors and networking that 
will be added to the project 









VEX is not 
} dissimilar to 
\A Z «: ee Lego Mindstorms 





The robot and Raspberry a : % ra Se , VEX has 
Pi are just above the 
plants, with the robot arm 
Tate) Uiare r= lamoleldolelmcolare| 
water pump 







regular robotics 
competitions for 
young makers 







Like a lot of 

robotics projects, it 
has a huge amount 
of growth potential 


A 3D-printed part 
allows for VEX / 
Raspberry Pi 
communication 


The water pump is 
operated by a relay, 
so be careful if you 
plan to recreate it 
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Seedling watering 





the wiring of the breadboard and peripherals as 
part of my project was an added bonus.” 

Raspberry Pi keeps track of time. When a eee es ene oe pecaaeed sa Heine 
predetermined time passes, Raspberry Pi Raspberry Pi. “For one, with its multitude of 
triggers an LED light on a breadboard. sensors, accessibility to networks, and bountiful 
options for programming languages, lit] provided 


™ However, as the idea 

<S formed, other benefits of 
using d Raspberry Pi arose @ 

a flexible solution that could not only be used in 


this project, but whose lessons could be expanded 


A The hillrdbok ann to other projects. This project could have been 





looks wacky but is done more simply with a UART connection using 
elk an older model VEX EDR microcontroller. This 

x He aleserc las way, the transmission of information would have 
3D printing then been direct. But by doing the project with 


The LED light is sensed by the VEX IQ 
microcontroller that will move a watering arm 
over each seedling. 





As the arm is over a seedling, the VEX lQ 
microcontroller pushes a button that is sensed 
by Raspberry Pi and triggers a watering pump to 
stream water over the plant. The apparatus does this 
for each plant and then resets. 
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P The full VEX system 
enclosure hooks up 
to Raspberry Pi 


the Raspberry Pi VEX IQ communicator, I learned 
about 3D printing, circuits, LEDs, and GPIO pins.” 


Let them grow 

We’ve seen that Raspberry Pi can help grow plants 
and such, but can a Raspberry Pi/construction 
block robot hybrid do the same? 

“Tt works quite well,” Chloe says. “There 
is a YouTube video that shows not only how it 
works, but a couple examples of seedling growth 
(magpi.cc/seedling). I had to connect the VEX 
IQ microcontroller to a constant DC power 
supply. Sometimes, one in 40 waterings, one 
of the motors would seize up and my apparatus 
would commit egregious overwatering. This was 
uncommon, however.” 

Chloe isn’t resting on her laurels either: “1 
want to learn more about networking. My goal is 
to create an easy-to-use interface to be able to 
manipulate the apparatus from distant sites. I 
also used the Raspberry Pi VEX IQ Communicator 
to create an automatic pet feeder and water bowl 
filler. There is a short video on the same YouTube 
channel of this device. The pet carer is in a more 
nascent stage of development.” {il 
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<4 A pump is used 
to supply water to 
the system 
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ommodore 64 
evamp 


Be like Stephen Williams and bring an old computer 
back to life. David Crookes takes a look 








Stephen 
Williams 


Stephen is an 
original 1980s retro- 
computer owner 
and a jack-of-all- 
trades who is happy 
to try new things. 
When not tinkering, 
he likes getting 
outdoors, exploring, 
and spending time 
with his family. 
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can be turned into a brilliant, action- 

packed retro gaming arcade. Using 
operating systems like RetroPie, you can easily 
switch between emulators of many age-old home 
computers and consoles, and scores of makers 
have made use of this in various weird and 
wonderful ways. 

In this instance, Stephen Williams has brought 

a broken Commodore 64 (C64) computer back to 
life. He’s stripped out the original motherboard, 
replaced it with a Raspberry Pi computer, and 
used Lego bricks to build the internal housing. 
It reminds us of Christian Simpson’s fantastic 
Brixty Four project (magpi.cc/brixtyfour). But 
while that sought to create a new C64 case out of 
Lego, Stephen’s project retains the original, iconic 
“‘breadbin’ plastic. 


A s many readers will know, Raspberry Pi 


A Externally, the Commodore 64 Revamp 
appears identical to the original. 

Keyboard mapping software is used to 
communicate with Raspberry Pi 
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“Tve played with Raspberry Pi since the 
computer first came out, making and discovering 
new things along the way,” he tells us. “I had 
a truly broken Commodore 64 that I felt would 
benefit from a new lease of life. My project 
blends retro with a modern twist, and brings 
together some of the things I’ve liked to play 
with over the years — notably Lego, the C64, 
Raspberry Pi, and Arduino.” 


Building the project 

Stephen turned to Lego for a practical reason. “I 
didn’t have access to a 3D printer, and Lego has so 
many different pieces that it’s really versatile to 
experiment with,” he says. “I already had a Lego 
Raspberry Pi case, so it seemed to make sense to 
build around it. I wasn’t sure what the fit would 
be like inside the C64, so I bought a mix of pieces 
from a market stall to see what would work.” 

He says it was important to build a solid base 
inside the C64 and position the USB, HDMI, and 
other ports in the right places. “I didn’t want to 
modify the computer’s case in any way and Lego 
helped me to do all of this.” The rest of the build 
was rather straightforward and involved inserting 
a Raspberry Pi computer into the case so that the 
ports were accessible, inserting a microSD card 
with RetroPie installed on it, and connecting to the 
C64 keyboard. 

To do this, Stephen used an Arduino Micro. “It 
provides the mechanism to get a fully working C64 
keyboard for Raspberry Pi,” he explains. “The basic 
idea is to scan the pin readings on the Arduino 
which are connected to the row and column pins 
on the C64’s matrix keyboard. Using the Arduino 


Po“ — ei 






The cables are routed to the 

Co} a(ellatc\ Mate) (--M lam ig(-M Oley Mer-I-¥-larel 
they're connected to Keystone 
inserts to provide accessible USB, 
HDMI, and network ports 


Raspberry Pi sits within the 
Multicomp Pi-BLOX case which 
Stephen bought from The Pi Hut 





Ul Tave Yolo Marie (= ma al=y 

CoYatellate\ M@xelaalaalele(ole- Moy Mera Is1-) > 
enabled Stephen to keep the 
components firmly in place 





Lego has so many different 
pieces, so it's really versatile | Niocading st 


electronic skills 


to experiment with : » ate needed 


The original C64 
case is not 
modified either 


software libraries, the row and column pins are 
scanned, and the mapped keystrokes are sent to 
the computer connected to the Arduino via USB.” 
A ‘(Pree A It's a great way to 
Pulling it apart S Tite age - revive a broken C64 
Since creating this project, Stephen has acquired a L e } 
3D printer. As such, he’s been replacing the Lego EY \ % ri a \ You can even use 
using printed parts, again for practical reasons. yy wae ens USB joysticks 
“When Raspberry Pi 4 came out, I wanted to use it ane 


but because I needed to install a fan, I couldn’t use Try applying the 


build to VIC-20 and 
C16 computers 


the Lego Pi case any more,” he says. “The 3D build 
means I’ve been able to get closer to the original 
Commodore 64 regarding the location of the power 
socket and switch.” 


Even so, he’s not always entirely faithful to the 
C64. “Since RetroPie brings many emulators into 


one place, it’s been a bit surreal playing a Spectrum The 3D-printed build, 


3 yy ‘ f ari f 
game with the C64 sitting in front of me, but I’ve pease ees 


become used to it. RetroPie is also easy to extend requirements are 
. . also needed for 
to include things such as homebrew programs, Raspberry Pi 4 
media players, and bespoke themes. It’s been fun ee tUps GUE tot Using 
. micro HDMI and 
to dabble with these too.” USB-C ports 
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Art had to be rescaled, 
but it's been done faithfully 


Arcade Cabinet 


Why pay over the odds when you can build an accurate replica, and have fun 
doing it? Rob Zwetsloot switches off his targeting computer to have a look 


etting the arcade machine of your dreams 
gets a little harder every day, especially the 
older they are. Making one, however, is always 
possible if you have the right skills and a Raspberry Pi. 
“My project was to build a replica, or as close as 
I could reasonably manage, of the Atari Star Wars 
arcade cabinet,” James Milroy tells us. “I really 
. wanted to build a cockpit as that’s what I played on 
James Milroy in the eighties, but sadly I didn’t have the room to 
house it, so the compromise was to build a stand-up 
A postman who . : 
loves making and cabinet instead.” 
fixing things in his Even then, the standard cabinet has a lot of detail, 
free time, and spent —_ and James really nailed the look of it. Why build it 
eee tee from scratch, though? “Initially, I had toyed with 
in arcades. , 
sourcing an original cabinet and restoring it, but 
soon gave up on that idea after finding it nigh on 
impossible to source a cabinet here in the UK,” James 
explains. “Almost all cabinets for sale were located 
in the USA, so they were out of the question due to 
the high cost of shipping. Atari only made just over 
12,500 cabinets worldwide, so their rarity meant that 
they commanded top dollar, effectively putting them 
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out of my price range. It was at this point that 
I decided that if it was going to happen, then I 
would have to make it myself.” 
Making a cabinet is hard enough, but the 
control system would have to be an original Atari 
yoke. “The Atari yoke is considered the ‘holy 
grail’ of controllers and, again, is very hard to 
find,” James says. “My prayers were answered 
in October 2018 when a thread on a forum I was 
subscribed to popped up with a small Utah- 
based startup aiming to supply replica yokes at a 
realistic price to the arcade community. I grabbed 
two of these (one for my friend) and the project 
was on.” 





Good feeling 

When it came to actually emulating the game, for 
James there was only one choice: “My decision 

to go with a Raspberry Pi was a no-brainer really. 
I had previously made a bartop cabinet using a 
Raspberry Pi 3 and RetroPie/EmulationStation 
which | was really pleased with. Sol hada 


NaHDLVA 


The cab is made with 
MDF, and includes 
iat-me) ale) latclm@slaa 


The yoke is an accurate 
c=) oh (or- Wa datel mere) al at qtel Ko Ke) 
Raspberry Pi via USB 





The original game 
came out in 1983... 


The same year as 
Return of the Jedi 


The riser was a custom build 
by James that emulates 
lights from the films 


It used special 
vector graphics to 
emulate 3D space 


A Picade X-HAT 
handles everything 
but the replica yoke 


A lot of custom 
work was done to 
downsize stuff to 
3/4 scale 
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4 3D-printing the mouldings and 
details is easier than recreating 
them with vacuum forming 






4 The coin slot is fake, 
and just requires button 
presses to add credit 


platform that I already had experience with and 
knew was more than capable of emulating the 
one game I needed to run. Besides, the simplicity 
and low cost of the ecosystem for Raspberry 
Pi far outweighs the extra expense and effort 
required going down the PC route.” 

With a custom build and emulation, 
authenticity of the gameplay experience could 
be a bit off. However, that’s not the case here. 
“T think that it plays just like the real arcade 
machine mainly due to the inclusion of the 
replica yoke controller, and adding your credit by 
pressing the button on the coin door,” says James. 
“Ideally a vector monitor or a CRT would goa 
long way to making it look just like the original, 
but a reasonable representation is possible on an 
LCD using shaders and anti-aliasing. Gameplay 
does seem to get really hard really quick, though; 
this could be due to an imperfect emulation, but 
is more likely due to my reactions having dulled 
somewhat in the last 38 years!” 


Always in motion 
While the current build is amazing as it is, James 


4 Audio and lights are easier : : : 
to install with modern tech — does have some ideas to improve it. “Overall, I’m 





18 | magpicc | 3/4 Star Wars Arcade Cabinet 


F) Reme- \T 
f | so Sid 
Aohie & M9 


=k Ei aaa 








4 The wooden parts are laser- 
cut for added precision 


really pleased with the way the cabinet has worked 
out,” he says. “I will be replacing Raspberry Pi 

3B+ with a Raspberry Pi 4 to enable me to runa 
newer version of MAME which will hopefully offer 
a better emulation, sort some audio glitching I get 
with my current setup, and hopefully enable some 
graphical effects (such as bloom and glow) to make 
it look more like its running on a CRT.” H/ 


PROJECT SHOWCASE | Mdg?i 





Accurately replicating 






THE COIN VIDEO EXPERIENCE 






“Luckily... | managed to have a play on an 
01 original cabinet at the Game On exhibition 
at Glasgow Braehead Arena. Armed with my trusty 
tape measure, | got some vital measurements from 
the real cabinet and after that, everything fell 
into place.” 






r Pere gl) \h 
Nt v4 
: Him @ 

02 The cabinet was designed and laser-cut from 
MDF. There's some steel in the construction, as 

well as tempered glass over the screen. Mouldings 

are 3D-printed, with the help of a graphic artist who 

also helped rework graphics to fit the smaller size. 


Lastly, a riser is constructed to make sure it's tall 
enough to play. 










ai 


oo 


i U 
3 
03 “The workings were simple when it came 
down to it: Raspberry Pi 3B+ with Pimoroni 
Picade X HAT. This gives us a power switch, audio 
amp, buttons, and a joystick if necessary. The replica 
yoke is interfaced with a USB adapter from the same 
company. It allows us to use the yoke with the original 


Atari connector. Software is RetroPie and I'm currently 
emulating on AdVMAME.” 
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Dede Mitchell 


New Orleans-based 
Dede Mitchell 
provides logistical 
and administrative 
wizardry at non- 
profit or-nola.org. 
In her free time she 
builds one-of-a- 
kind “tech-infused" 
custom costumes, 
wigs, and hats. 
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A cartoon burger joint inspired this fun Raspberry Pi 
Zero creation. Rosie Hattersley hears how 


ede Mitchell’s colleagues are so used to 
seeing her in wigs, costume, and outlandish 
make-up, they barely bat an eyelid. In a city 
full where “we costume all the time”, dressing up 
is practically de rigueur, but native New Orleaner 
Dede loves to add a tech twist. Her latest, the LCD 
Chalkboard (magpi.cc/lcdchalkboard), is her first 
ever Raspberry Pi project. 

Making costumes for herself and others under the 
guise of the Maladjusted Milliner takes up much of 
her evenings and weekends, while Dede’s day job is 
as an intra-office administrator and logistics expert 
at Operation Restoration (or-nola.org), a non-profit 
organisation where “an awesome group of women 
provide assistance to women and girls affected 
by incarceration”. 


Food for thought 

Faced with more downtime than she knew what to 
do with during lockdown, Dede was keen to keep her 
mind active and decided to learn about Raspberry Pi. 
After “binge-watching” the cartoon TV show Bob’s 


LCD Chalkboard 


Dede can bring the smart 
chalkboard to life with a tap 

on her phone; coming up with 
witty missives takes a bit longer 


Burgers, an idea for her first Raspberry Pi project 
began to emerge: the LCD Chalkboard was inspired 
by the burger of the day displays on the show, as 
well as “the many smart mirror projects online”. 
Dede is a confident and experienced wearable 
tech maker who builds “anything that comes to my 
mind. Usually I build wearables [for New Orleans’ 
parades including Mardi Gras], so I like smaller 
microcontrollers such as Trinket and Feather.” 
Her love of LEDs and blinking lights started when 
Dede was helping organise a STEM event for kids 
and was introduced to microcontrollers, Adafruit, 
and Arduino. However, coding didn’t click until 
she picked up a Raspberry Pi Zero W and started 
learning bits of Python and MicroPython. “For me 
it is intuitive and just makes sense,” she reports. 
“T love Raspberry Pi Zero W because, unlike a 
regular microcontroller, Raspberry Pi Zero W is 
a minicomputer. It allows me to build some of 
the projects that only live in my head right now. 
Interactive costume pieces are buzzing around in 
my head.” 








As well as having magic mirror-like features, 
the LCD chalkboard references maker Dede's 
love of cartoon TV show Bob's Burgers 
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She has no intention 
of giving up writing 
bad puns 





The Bob's Burgers 
TV show inspired 
this build 


Dede says her 
board is likely “to 
contain many bad 
Star Trek puns" 









\\ 
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er hh Pr 
. wads > 
7 if fv?» The board has a 
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: Fi aed New Orleans ’ ss ‘ . secret compliments 
socates' vs ¢ Ri / ' < ~< mode! 

/ " These provide pick- 


Dede made the chalkboard frame, so this me-ups after an 
is her first woodworking project, as well exhausting day.. 
as her first Raspberry Pi project 
and may also 
reveal the 


whereabouts of the 
chocolate stash! 
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Warning! 
Drill and saw 


This project uses an 
electric drill and saw. 
Be careful when using 
sharp tools. 


magpi.cc/drillsafety 





| love Raspberry Pi Zero W 
because, unlike a regular 
microcontroller, Raspberry Pi 
Zero W is a minicomputer 


Adaptable attitude 

By the time she began designing her chalkboard, there 

were three Raspberry Pi Zero W boards on hand. She 

needed to adapt the smart mirror example builds she 

found online as most were not for Raspberry Pi Zero. 

“But I did find a couple of guys that got it to work, so 

I cobbled together information from their sites and I 

was off to the races!” she says. 
However, using Raspberry Pi Zero meant she had 

to use it headless. At first she was intimidated by 

the command prompt, but having followed a useful 

guide she found online, it’s “so ordinary for me now, | 
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Dede upcycled an old yoga mat as 
the basis of this Nefertiti crown with 
microcontrolled eerie eye 


Dede's ‘tech-infused' Infinity Space 
Helmet features a trio of infinity 
mirrors and a microcontroller 





occasionally reboot or shut down my sign with my 


phone, from my bed.” 


The chalkboard design is all Dede’s. She decided 


to use whatever tools wer 
use a jig-saw and scroll-s 
she was happy with her s 


e available, and learnt to 
aw for this project. Once 
ketches and the design, 


the build process took around two weeks’ worth of 


evenings and weekends. To keep things simple, she 


stuck with the existing Raspberry Pi OS wallpaper, 


but intends to customise 


this with her holiday 


photos once her coding skills allow. 


She’s largely happy wit 
turned out and with Rasp 


h how the project 
berry Pi Zero W, but will 


eventually upgrade it to Raspberry Pi B+. “More 


processing power allows 
she reasons, and Dede is 
voice-recognition by addi 


camera. Along with learni 


script, and basic Linux co 


for better interaction,” 


keen to add face- and 

ng speakers anda 

ng “some basic Java 
mmands,” she’s going to 








invest in a framing square. “I couldn’t find mine 
during the build and decided to wing it!” HI 
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TT 


Setting up an LCD chalkboard is broadly 
similar to creating a magic mirror, for which 
detailed instructions are on GitHub 
(magpi.cc/magicmirrorgit). Apply chalkboard paint 
to one side of your plywood chalkboard, then cut 
out a hole the correct size and dimensions for your 
LCD. Measure and fit the frame. 


01 









4 Dede used YouTube to get 
tips on neatly sawing a hole 
in the plywood to fit the 
LCD, which she upcycled 
from an unwanted laptop 









Lay out and connect Raspberry Pi, AV 
02 controller board, SD card, and display power 
cables. A four-gang power strip helps organise 

power supplies. 






ray} Use sudo apt-get to install the magic mirror 
image to your SD card, insert into Raspberry Pi, 
and power everything up. 
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erminator HK Tank 


Scary futuristic robot alert! Phil King delves 
into the makings of this intelligent qutomaton 





Michael Darby 


Growing up 
watching sci-fi 
shows like Star Trek, 
Michael became 
obsessed with 


technology - robots, 


Al, holograms, etc. 
So, he's always 
wanted to try to 
make his own. 


314reactor.com 


> While the Arduino 


and motors are 
powered by six AA 
batteries, a high- 
capacity power 
bank is used for 
Raspberry Pi 


Skynet’s HK Tank is a fearsome military 

machine from a post-apocalyptic future — 
‘HK’ is short for ‘Hunter-Killer’. Standing several 
storeys high, this heavily armoured robot would 
trundle forward on caterpillar tracks, its bright 
searchlight probing the area for humans to blast 
with plasma cannons. 

Fortunately for humankind today, Michael 
Darby’s DIY robot version of the HK Tank 
(magpi.cc/hktank) is a lot less deadly, firing beams 
of light from RGB LEDs. “I have always been a huge 
fan of the Terminator films and I’ve always wanted 
to recreate the robots from them,” he tells us. 
“The tracked chassis [a DFRobot Black Gladiator] 
was perfect for this — it’s not dangerous, but it 
may bump into someone. The lights on it are also 
kind of bright.” 


E eatured in the first two Terminator movies, 





Enemy detection 

ot only does Michael’s robot look the part, it has 
numerous sensors to help it navigate, along witha 
Raspberry Pi Camera Module for spotting humans 
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and objects. If a human is detected, ‘purple 
plasma’ - or rather, a flash of the RGB LEDs — is 
fired at them. 

Mounted to one side, with a shiny gold heatsink, 
a Raspberry Pi 4 is the brain of the robot, handing 
the TensorFlow machine learning and AI functions. 
“Tt’?s using a pre-trained model, so! think it has a 
good few thousand things at least it can detect,” 
says Michael. “In future I will look into getting it 
trained on more things.” 


m Maybe it's just as well it's 
only firing light beams 


The robot’s Raspberry Pi also communicates 
with an Arduino which handles the low-level 
functions, such as controlling the two DC motors 
and reading no fewer than five ultrasonic sensors 
used for obstacle avoidance. “There are probably 
other sensors | could have used,” notes Michael, 
“put I thought these would be the easiest to 





PROJECT SHOWCASE | MdgPi 


Se 


8 


A Raspberry Pi Camera Module n 3 The robot is built 
is used to scan the area for = _—- " j A on a DFRobot Black 
EVaNmallagt-lacnced ol-imme(-1k-toitlate) a AY i! Be é a Vj Gladiator chassis 
them using machine learning SN eS | A 444 ith twin DC motors 





\I 





Quick FACTS ||!) 


» Raspberry Pi 
and Arduino 
communicate 

Fitted with a gold heatsink, a : ; 2 via serial 

Raspberry Pi 4 is the robot's 

ey ccllaMMudallcowelaWatce 6 llace) ~~ 

handles low-level functions 8 Og , me | f 

y) 







» Find all the code on 
GitHub: magpi.cc/ 
hktankcode 






; H)\ 
f 


» Michael's previous 
projects include 
Terminator glasses 
and a robot head 


py Ve) LL) / oy = ih Bi 


implement. There are two on the front to make Michael. “From here it can be set to identify certain 
sure it doesn’t hit a wall (and also help with the things and react in a certain way, such as spot a Pe eee ea ie 
5 a : Ss ‘S Cc 
aesthetic) and the others are all in place to prevent human and light up the ‘plasma turret’ RGB LEDs.” on ane . 
it from hitting things behind it, or driving off of the While the robot has received positive feedback Wnsapiee ve 
edge of things.” from the community, he’s planning to make 
. improvements, such as training the model on > He plans to 
Join the queue specific faces and “allowing for more complex improve his 
With the project taking “a good few months” to patrol patterns and ‘missions’ and make it more of Raspberry Pi 
develop, Michael says the most difficult was sorting | an autonomous bot.” Maybe it’s just as well it’s only Chatbot project 
out the code — written in Python — and getting it to firing light beams. using Docker 
do what he wanted. “This project had some really 
F V_ Byremotely connecting to Raspberry Pi, 
new stuff I was trying, such as the event queue to you can view what it's up:to. Here. the 
allow asynchronous processing; this is where it robot's Al has detected a human 
+ » u i UN! =O4.0 70 
eally aot complex. : 2 . OE TECT:PERSONICONF =79,0% 
Rather than handling one function at a time, the ICONF£81,0% 
code is based on an event queue. All functions are PRI_MSN:pers =terminate 
threaded and running simultaneously, dropping “e iy 
3 7 I_MSN: per sonjACT=terminate 
their results or requests into the central queue. ELD PNM 
This prevents conflicts and is based on priority ACTION:EXECUTE STERMINATE 
for the functions: “If there is a module that OOIES TYICUanepe os 
requi thing to happen sooner, like some > ag (herded hs : 
equires something ppen P : a Be DERE oe 
kind of priority action for moving to a location, or 71.0% TARGET: PERSON» 


TERMINATE 





recognising a person, it will be handled before a 
lower-level action such as processing an object that 
isn’t a mission parameter.” 

Mission parameters are stored in YAML files 
rather than hard-coded. “You can essentially give 
it commands via a YAML file that contains all of 
its standing orders and configurations,” explains 
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Raspberry P1 
Refrigerator 


Your Raspberry Pi computer can look after the delicious 
pies in the freezer, as David Crookes discovers 








Rick Kuhlman 


Rick is Head of 
Product for the 

loT dashboard 
platform Initial 
State by Tektronix 
(initialstate.com). 
He has more than 
15 years experience 
in loT and SaaS 
leadership roles 
working on smart 
locks, mobile apps, 
connected car 

and video. 


magpi.cc/rpfridge 


a real risk any food or other items placed 

inside a fridge or freezer will become spoiled. 
According to experts, refrigerated perishable food 
needs to be thrown out after four hours without 
electricity. Anything kept in the freezer will last 48 
hours — but only if it’s full. 

It’s a good idea, then, to create an alert system 
that will inform you if your fridge or freezer is 
suffering a drastic drop in temperature. One such 
solution has been created by Rick Kuhlman, who 
has sought to save the world’s frozen pies (and 
other foodstuffs, of course) from being destroyed 
by making good use of a Raspberry Pi computer. 

Rick got to work after witnessing the 
devastating effects a power cut can cause when 
his wife lost months’ worth of breast milk during 
an outage. By connecting an Adafruit integrated 
temperature and humidity sensor to a Raspberry 
Pi Zero using a flat flex cable, he’s developed a 
near-perfect, low-cost solution. 


[ f the power in your home is cut, there’s 


Keeping cool 

“Raspberry Pi Zero is inexpensive and extremely 
capable,” he says. “It’s especially nice for small 
headless projects with wireless LAN connectivity. 


M Raspberry Pi Zero is inexpensive and 
extremely capable H 


But the biggest reason | turned to this computer 
is because of the community, documentation, 
and tutorials that already exist. Unknown issues 
can be solved quickly by learning from the shared 
knowledge the community constantly generates.” 


26 | magpicc | Raspberry Pi Refrigerator 


A Wires from the encased sensor are soldered 
to Raspberry Pi Zero. The maker wants to add 
a door sensor, too, for speedier alerts 





At first, Rick played around with wireless 
sensors and items from the SmartThings platform. 
“Tt seemed elegant but the well-below-freezing 
temperatures totally degraded the batteries, and 
I wanted a reliable solution that didn’t require 
constant fidgeting to keep it working.” 

He experimented with different wiring across 
a freezer’s vacuum seal and he considered ultra- 
thin thermocouple wire. “Ultimately, though, 

I wanted to use the Adafruit sensor because 

of its temperature range and simplicity of 
integration with Raspberry Pi. The flat flex cable 
was key to getting signals across the freezer 
seal without leakage.” 


Avoiding the cut 

Setting up the hardware proved straightforward. 
The relative difficulty came in creating the 
accompanying software. “Raspberry Pi OS Lite is 
great for headless applications, but it takes more 
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The I2C bus is enabled on Raspberry 
Pi Zero which has the Python module 
RPi.bmez280 installed on it. This reads 
and parses the data which is streamed 
to the Initial State loT platform 






> The whole setup 
costs around $30 


» It uses Initial State 


» The app boots 
when Raspberry Pi 
Zero starts up 

The Adafruit BME280 sensor Z lol The information is sent via the flat flex = > > SMS and emails 

ag (or-| oK-mUlcilale Mdal-M-X- ate |merelaalaalelalcer= ii (ola) Me are sent if 

protocol I2C. The cable's flatness means * temperatures drop 

the freezer door can still close flush ’ 


measures temperature and 
lalelaalce linvamexelan{-1ailaremaal=y 
values into digital data 


> Mobile and desktop 
dashboards have 
been created 


configuration to set up and install the modules, 
libraries, and SDKs properly,” Rick says. “Getting 
wireless LAN setup headlessly, getting SSL 
access, and starting the app on bootup is not very 
discoverable either.” 

But once he had everything in place, coding the 
app was smooth. Rick used the IoT platform Initial 
State, so Raspberry Pi Zero only needs to stream Temperature Trend (°F) eae 
the data via Initial State’s Python SDK. “Without — 
any extra coding on the device, I was able to create E ae 
SMS/email triggers for temperature thresholds - 
and data dropouts,” he says. “TI also calculated Kt ill il Wu ° . aA (e 
and displayed the various statistics and unit cal 
conversions using the expression engine.” = wale Sid dev 


You can view the status of the fridge online ae 


(magpi.cc/freezermonitor). Humidity Trend (%) dates 
The device has been running flawlessly for six — = 


months, already sending alerts via text and email 
when the power was cut due to storms around his 
home in Nashville. It has also let Rick know when 
the door was left open for too long, heading off 

some potential meaty disasters. “I’m now able to 
sleep easy knowing my prime briskets are safe and Sinte, hpaecivesseknaverg 1eninnhiules 

sound,” he laughs. im} and allows for data to be viewed in real-time 


Median 





A Adashboard has been created in Initial 
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Modern 
Jukebox 


This 3D-printed mini jukebox combines a retro 
feel with modern music and podcast streaming, 
Nicola King has a dime ready 


S 





Bob Murphy 





Bob (aka 
thisoldgeek) 

was a database 
administrator for the 
Clorox Company. In 
retirement, he has 
time to indulge his 
childhood dreams 
of making things. 


magpi.cc/ 
thisoldgeek 
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about the elegant lines of a jukebox, and 

Bob Murphy’s childhood memories are a 
key driver behind why he decided to recreate this 
particular piece of vintage nostalgia. “My father 
had a1940s floor-standing Zenith radio that I 
enjoyed listening to as a child,” he shares. “That 
kindled a long-term interest in jukeboxes and Art 
Deco. I set myself the challenge of building my own 
jukebox, both for the learning experience and the 
satisfaction of having a personalised object.” 

So, Bob set about his task — a time-consuming 
build, as the printing of the casing and parts for 
the jukebox took over 75 hours to complete, not 
accounting for the failed prints. “My printer is a 
Prusa i3 MK3S, an excellent and reliable printer,” 
Bob tells us, “but it requires mechanics like the 
belts to be properly tuned and adjusted. Once the 
printer and 3D software are dialled in, it’s stick-to- 
it. Major parts took from 4-12 hours to print, over 
about four months. 3D printing is iterative, and I’m 
a poor planner. A few long reprints were needed 
once the electronics were ready to be fitted, to 
correct for clearances and other problems.” 


T here’s something comforting and charming 





Light fantastic! 

So, what do the internal workings consist 

of? “Raspberry Pi is at the base of a stack of 
electronics,” says Bob. On top of Raspberry Pi, 
which runs the Volumio music app, Bob has an 
IQaudio DigiAMP+ HAT to route music to two 
Dayton Audio RS100-8 full-range speakers, and 
above that is an Adafruit Perma-Proto board 
powered by 5 V from the IQaudio amp. “That 
board hosts a SparkFun Sound Detector through 


Modern Jukebox 






A Mounted on Raspberry Pi, the 
electronics include an Arduino 
Micro, SparkFun Sound Detector, 
and an |Qaudio DigiAMP+ 
connected to two speakers 


an Arduino Micro. The Arduino uses the Sound 
Detector output to power NeoPixel strings for 
sound-reactive lighting effects.” 

The Modern Jukebox can be controlled either by 
the touchscreen display or via a web page froma 
computer, tablet, or phone, courtesy of Volumio. 
The user can raise and lower volume, choose music, 
skip tracks, pause/play, and so on. “On the back, 
there’s an on-off switch and a switch that controls 
the NeoPixel LEDs,” Bob reveals. “The ‘Tube’ LEDs 
around the outside can be set to sound-reactive, 
bubble/chaser through a colour wheel, or off. The 
LEDs around the grille rotate through a colour 
wheel at startup, then stay lit always.” 


Adopt, adapt, improve 

Bob is very appreciative of the work of others that 
has inspired and aided him in his jukebox design. 
“This jukebox was such a long project, it wouldn’t 
be possible without prior art from other makers,” 
he notes. “I built on the efforts of Marco Gregorio 


The vintage-style jukebox 
case is constructed from 
numerous 3D-printed parts 


reactive light show, the 
‘neon’ tubes are fitted 


| | aceniileliare re Bsel6 ale te 
with NeoPixel strips 
t 


M |t takes an unknown 
amount of time and it's 
done when it's good! @ 


(magpi.cc/jukeboxdesign) for the 3D jukebox 
model, and Michael Bartlett (magpi.cc/ledmusicviz) 
for the lighting effects.” 

Bob learnt from the work of these makers and 
adapted it for his own project. “I modified Marco’s 
excellent full-sized, solid 3D Wurlitzer model. There 
were a very large number of components to review 
— what to keep, what is missing —- to make this a 
scaled-down, modern-tech, 3D-printable object.” 

It’s fair to say that Bob’s Modern Jukebox has 
been a labour of love, but he’s received some 
super-enthusiastic feedback from makers and 
admirers, with one friend asking, “Wow - is 
he taking orderse” Bob estimates that he has 
spent around 160 hours in the course of a year 


Connected to a Raspberry Pi 
running Volumio, the touchscreen 
Cof= lal ol-MUli-10 mKoMexe)al ice) maale (cies 
playback and volume 


on his creation, but a quality output requires an 
investment of time. “I’m not on a deadline, so my 
approach to projects is like ‘painting the Sistine 
Chapel’ - it takes an unknown amount of time and 
it’s done when it’s good!” 


Quick FACTS 


> The jukebox 
uses a standard 
3A/12V DC output 
power supply 


Bob has made 
several interesting 
Raspberry Pi 
projects before.. 


including this 
aesthetically 
pleasing clock: 
magpi.cc/ 
artdecoclock 


wand this 
vintage-style 
but technically 
modern radio: 
magpi.cc/miniz 


Bob is planning 
to use Raspberry 
Pi Pico soon ina 
new project 


i 


A Bob selects a song on the 
touchscreen panel, which 
shows Volumio's intuitive 
user interface 
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ey — 
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he world of Raspberry Pi computing 
e T is filled with possibilities. Sometimes 
this can lead to a feeling of being 
overwhelmed: Where to start? Before you go 
launching into your great project, it’s worth 
taking the time to get to know your little 
computer and its big possibilities. 


A Raspberry Piis more than a 
microcontroller, such as its new sibling the 
Raspberry Pi Pico. Raspberry Pi is a full-blown 
computer with a complex operating system. 
Here we’ve compiled some of our favourite 
hints, tips, and short cuts to help you navigate 
this new world. 
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Create a custom OS 

The Raspberry Pi Imager tool 
(magpi.cc/imager) makes preparing your 
SD cards a breeze, and the latest version 
now features a new Advanced menu. It 
is accessed by pressing CTRL+SHIFT+X. 
This enables you to preset your wireless 
LAN network, host name, and many other 
options. Ideal for multiple setups, trying 
new operating systems, and headless 
projects (where you don’t need the 


graphical interface). 
? Go configure! 

Raspberry Pi OS has features and 
- settings that can be used to create an 
ideal setup. For example, if you want to 
interface with an I2C-based device or 
a Raspberry Pi camera, you’ll need to 
enable support. The utility you’ll need 
is Raspberry Pi Configuration. This can 
be run from the interface using Menu > 
Preferences > Raspberry Pi Configuration. 
You can also run it from the command 
line like so: sudo raspi-config. 


Manage your memory 
Raspberry Pi OS reserves a certain 
amount of memory for exclusive use 
by the GPU (graphics processing unit). 
If you’re not making use of a desktop 
(such as a headless project) or if you are 
wanting a boost for a graphics-intensive 
Fp) ob Cer-uloy oMmnrcole mer. bole) ak-berexem eXeyivmenlecaley 
memory is allocated in Raspberry Pi 
Configuration under Performance. 





4 Make your desktop 
your own 

Not happy with the default look of the 
desktop? No problem. Visit Preferences 
> Appearance Settings and you can 
change fonts, colours, placements, and 
the background image. If you want to 
Feo duban oXcsammrColumer-bomanatemost-boymequarelcts 
to creating different environments 

on the web. You can even replace the 
default desktop window manager 

with alternatives. 


Get more software 

Raspberry Pi OS comes with lots 
of software to get you started, from 
programming environments toa 
complete suite of office software. This is 
just the beginning. Take a look at Menu 
> Preferences > Add New Software and 
you’ ll find thousands of packages that 
are one-click installs. Check Menu > 
Preferences > Recommended Software for 
the top picks. 


Backup, backup, backup! 

If you’re storing data that you can’t 
afford to lose, make sure to be backing up. 
One of the easiest methods is to clone the 
whole SD card (although it can get large!). 
(©) oX-ol qo} Urom mob kcweaub CeLcbap vT-1249) ec] by-Cel qt 


7 Accessibility 

Raspberry Pi OS has optional tools 
to assist people. In the Recommended 
Software application under Preferences, 
select the Universal Access category to 
install Orca, a popular screen reader, 
and Magnifier which enables easy screen 
zooming. Also, be sure to read our ‘Make 
Making Accessible’ feature in The MagPi 
issue 96 (magpi.cc/96). 
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Meet the terminal 

On the top bar of your desktop, 
you’ll see a small black box with a blue bar 
on top. This is your link to the command 
line via Terminal; the real power of 
Raspberry Pi OS. Pressing CTRL+ALT+F1 
to F6 opens six different full-screen TTY 
(teletype) command-line interfaces. Press 
CTRL+ALT+F7 to return to the regular 
desktop interface). 

The Terminal gives command-line 
access to your system. When following 
projects in The MagPi and online, getting 
to know this way of talking to your 
Raspberry Pi is essential to growing your 
skills. Learn more at magpi.cc/terminal. 
Gg Pick your favourites 

See that toolbar at the top of the 
screen? It is endlessly customisable. You 
can select your favourite apps for one- 
click access, change its size, position, 
make it disappear when you ‘mouse 
away’, even have multiple panels. Just 
right-click on the toolbar to explore all 
the options. 


1 Take a screenshot 

Need to take a quick picture of 
your desktop? Couldn’t be easier. Just 
press PRINT SCREEN and a PNG image 
will be placed in your home folder. If 
you would like more options, such as 
a timer, the software does the work. 
The screenshot command scrot can be 
Faubolpanoyoommdel-Macoyonvant-voCembuot-moymicollma-vol 
install GNOME Screenshots. Read 
magpi.cc/screenshot for a full guide. 
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1 All the microSD Cards 1 Get kitted up 


One of the great advantages of For newcomers to physical 


using SD cards is their similarity to computing, the number of components 
cartridges. Trying out a new OS or project available can be overwhelming. Check 
build is as simple as swapping out that the popular Raspberry Pi market sites 
little piece of plastic. Make sure you buy for brilliant starter kits with all you need 
cards from a reputable source: there are andnothing more. BoththeJAMHAT $$ eos 
many out there that are not built for the (magpi.cc/jamhat) and CamJam EduKit 
workload to which an operating system (magpi.cc/edukit) are great places to start. 
‘ subjects them. Take a look at the Starter Kits section in 


our Gadget Guide (magpi.cc/gadgetguide) 


E 
(11) for more equipment. (i ha 
\ X ® eo 











; © . Of RASPBERRY PI OS HAS FEATURES 
FAN =) 2 oe ee Fe eV | 2 © 4 Fe) 
AY ee OM of) 7.0 -2.N Be) 7.0 oe) —9 of 9D 
oo Yat eae , 
1 Volt or bolt 14 Build your own robot 
Raspberry Pi GPIO pins can power The ability to drive motors and 
accessories at 3V3 or 5V. Check and check servos along with the horsepower required 
again before connecting devices to one of to process sensor data make it a natural 
these. The wrong one may damage your choice. There’s a lot to it though, and you 
device or the computer itself. Also, be can quickly find yourself with a full-time 
Faubboebaul Moym@ aon; (mentite oma tian-seUmyolli@lmele\iA hobby. Robotics expert Danny Staple 


Finally, never connect a5V pin to a3V3 pin: wrote a great guide to building a low-cost 
that would be the end of your Raspberry Pi. | wheeled robot for us (magpi.cc/robot). 


15 eremelatel (eye [el =1 
With the exception of the newest 


family member, Raspberry Pi Pico, 

the range of Raspberry Pi computers 

has been a strictly digital-only GPIO 
platform. If you want to read or write 
analogue data, such as light or moisture, 
you’re going to need some help. Luckily 
many HATs can add this feature, such 

as Pimoroni’s Automation HAT Mini 
(magpi.cc/automationhatmini). | 
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1 Amazing camera work 
You’re probably familiar with 
the Raspberry Pi camera family. Did you 
know that they can do much more than 
take photographs? Use open-source 
tools like TensorFlow and OpenCV to add 
machine learning, object recognition, 
and even facial identification with simple 
code. There’s an amazing resource at 
pyimagesearch.com. 









- 


1 Get your motor running 
sMor-Nelbban-seum-votemo)le-txcmacrelennncrel 

for driving robot motors is not something 

that is going to keep your Raspberry 

Pi healthy for long. A robotics HAT is 

essential if you want your Raspberry Pi to 

control servos and motors. And to become 


truly portable, you’ll need extra power too. 


For exceptional power and control, have a 
look at our RedBoard+ review in The MagPi 
issue 91 (magpi.cc/91). 


1 Get a 3D printing 
octopus 

If you’re a fan of 3D printing, you 

may have come across OctoPrint. 

This full suite of tools for controlling, 

monitoring, and recording 3D prints is 

also available as a custom Raspberry Pi 

image (magpi.cc/octopi). It’s one of the 

best upgrades to a 3D printer you can get. 


Take a look at our 3D printing and making 


feature in The MagPi #97 (magpi.cc/97). 


+ v 


FEATURE ‘Might © 





17 Raspberry Pi, Pico and 
Arduino, oh my! 

If you need analogue inputs and 

fast responses, consider using a 
microcontroller like Raspberry Pi 

Pico (magpi.cc/pico) in your project. 
Microcontrollers are much faster to 
respond to input. You can then use 
interfaces like UART, 12C, or SPI to feed 
data to your Raspberry Pi computer for 
more advanced processing. 





? 0 Right one for the job 


You don’t always need the full 
capabilities of Raspberry Pi 4. Consider 


a Raspberry Zero W for smaller projects. 


It may not have the performance of its 
larger sibling, but still offers the full 
Raspberry Pi OS, wireless LAN, and 

13) Let=snoXoyi ols co) mr-bour-boer-VAbelom oye (Qomm ODE 
course, the newest family member, 
Raspberry Pi Pico, brings amazing 
performance for under £5. 
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71 Supercharge your 
coding experience 


Over the past few years, Microsoft’s 
Visual Studio Code (magpi.cc/vscode) 
has become a de facto standard in 
development. It’s more a turbocharged 
text editor than a full IDE, but its 
dizzying range of extensions brings 

it close. Visual Code is available for 
Raspberry Pi OS and also has extensions 
for remote editing over SSH and 
uploading to Raspberry Pi Pico. 


teeee 


Prten rae 





? ? Protect your code with 


0 NO-CODE IS 


’ version control 23 Code without coding 
° Ta IN 4 @) = Git, the rather oddly named application, Tipped to be the way of the 
: : : : is an essential tool for every developer future, ‘no-code’ is a way of building 
BUILDING (github.com). It is a bit like time-travel applications without writing text, 


y.¥—)—) a os ‘ATIONS: for your code, allowing you to ‘snapshot’ Soko} moked ihymutcynetcar-maloyivolot-bamentcie-lo) avo) n 


your project and then rewind if you make to get inputs, apply logic, and produce 


WITHOUT - a mistake, delete a file, or just change outputs. Raspberry Pi OS is ahead of the 
. F your mind. It’s also great for collaborating curve: try Scratch (magpi.cc/scratch), 
WRITING i> on 77 on projects, enabling developers to a building-block approach to making 
’ . ; work on the same piece of code without fun applications, or the more powerful 


: a ® & al & overwriting each other’s work. Node-RED (magpi.cc/nodered). 
da 


e & 
— “te@ 


? Stuck? Ask Stack ? 5 Avoid code spaghetti 
Excha nge Programming languages like 
The Stack Exchange family of websites is Python and Node.js rely on massive 12. Virtual Environments and Packages 
a Q&A service for developers and other repositories of code libraries to extend 12.1. Introductic 
technical roles. If you’re stuck ona their capabilities. Different dependencies pile : 
problem, the chances are someone else (of-Voler- obo op no)o) (cdonkcmiiaud omecoyeuaaCelmbeted 
was too and turned to Stack Exchange for versions. Virtual environments allow 
help. This is an amazing resource whose you to ‘ring fence’ a project and its 
contribution to the coding community dependencies so you can avoid this. 
cannot be underestimated. There’s Python 3 has this capability baked in 
a dedicated Raspberry Pi forum too and it’s worth learning about it before a go eg 


(magpi.cc/raspberrypisxc). coming unstuck. See magpi.cc/venv. 
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The PIVPN Proj 


Keep ahead of the 

bad people 
Things move fast in the world of 
network security. Any Raspberry Pi 
device must be kept up-to-date with the 
latest software updates to ensure that 
any newly discovered vulnerabilities are 
mitigated. Regularly, run this command 
from the Terminal: 


sudo apt -y update && sudo apt -y 
full-upgrade 


A full upgrade is better than just ‘upgrade’ 


because it will remove packages if needed 
to update the system. 


P rotect your 

privacy online 
Fed up with ads? Don’t want your every 
move being tracked? Pi-hole is the answer 
(magpi.cc/pihole): a DNS-based ad- 
blocking solution for your whole network. 
Installation is a breeze, there’s a dedicated 
disk image for Raspberry Pi, and it can 
be configured to protect every internet- 
capable device on your home network. 
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SECURITY TIPS 


Change your password 

It’s obvious, but it bears 
repeating. Always, always change the 
default password. It takes under a 
minute and can save you significant 
grief, especially if your cool new project 
is connected in any way to the internet. 
Just run passwd from the command 
prompt or choose Menu > Preferences 
> Raspberry Pi Configuration and click 
Change Password. 


Raise your digital 

drawbridge 
If you’re using Raspberry Pi OS ina 
potentially hostile environment (e.g. 
anything that isn’t your home network), 
consider adding a software firewall 
such as UFW (Uncomplicated Firewall), 
which is based on the popular iptables 
software. This makes securing network 
access in and out of your device quick 
and easy. See ‘Securing your Raspberry 
Pi’ (magpi.cc/security). 


Access Raspberry Pi 
from anywhere 
The PiVPN project (pivpn.io) has recently 
added support for WireGuard, a new way 
of securely accessing your network from 
the internet. It only takes a few minutes 
to set up and clients are available for all 
major operating systems, as well as iOS 
and Android. An easy and secure way 
to get onto your home network from 
anywhere in the world. 
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NETWORKING TI2sS 


It's good to share 

Raspberry Pi 4 makes for a 
brilliant NAS (network-attached 
storage) device. Use it in combination 
with a USB drive as a network-wide 
file repository. The popular Samba 
file-sharing software allows Linux, 
macOS, and Windows machines to map 
drives. Ideal for family file-sharing. See 
magpi.cc/samba for a tutorial. 
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What's in ag name? 

Every Raspberry Pi OS 
installation comes configured with a 
network ‘host name’ of ‘raspberrypi’. 
AY,"ol=aolelo) ob oX-Yei-Yem Kom t(oltnmpel-ial(o}d em enters) 
than one of these is going to cause 
confusion, so it’s essential to set the host 
name of the device to something unique in 
Preferences > Raspberry Pi Configuration. 


Build a web server 
Raspberry Pi makes a brilliant 
web server and setting it up is as simple 
as running sudo apt install nginx. 
NGINX (pronounced ‘Engine-X’) is 
a modern, fast web server. Straight 
after install, you should be able to put 
your Raspberry Pi’s address in a web 
browser and see a ‘hello’ message. 
See ‘Setting up an NGINX web server’ 
(Gank-1240) eeeyp nt:4h 10.9 


Command Raspberry 

Pi from any computer 
SSH or ‘Secure Shell’ is acommon method 
of accessing a remote command line. It’s 
a great way for controlling Raspberry Pi 
devices that are hard to reach or running 
without a monitor or keyboard (‘headless’). 
Enable SSH in Raspberry Pi Configuration 
(under the Interfaces tab) and then log 
in from another computer using the ssh 
command-line application - or, if on 
Windows, puTTY. See ‘Remote control your 
Raspberry Pi’ (magpi.cc/ssh) for a tutorial. 


9 @ 
~ 


= 





e 
& Hardware 


Software Books &magazines Learn 


Refresh database of available packages 


g-to-date information about which 





eo 


| can VNC you e 
VNC is like SSH but for the 
entire desktop. It streams the desktop 
image to a remote computer and sends 
key presses and mouse movements 
back. Every Raspberry Pi OS Desktop 
| OK-TSIAVAN(@Mr-n1-00 10) (=u b) DL ms swe oop =p at-10) (cell ayia ; 
default, so just enable it in Raspberry 
Pi Configuration. Click the Interfaces 
tab and you’ll find it just under SSH. 
You then need a VNC client app on your 
remote computer, such as VNC Viewer or 
TightVNC. See magpi.cc/vnc for a tutorial. 


i. wae 
ne aliaadlilt | 
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3 5 The sudo that you do 
Raspberry Pi OS is very secure. 
One of the ways it protects itself is to 
only allow system-wide changes to be 
Foa¥eVe CoM onvaid oXcM-Leboebbobicyam-lutoyem Coymns KoYelam) 
user. A simple way to run any command 
as the root user is to prefix it with ‘sudo’ 
(Super-user Do). See ‘Root user/sudo’ 
(magpi.cc/sudo) for more info on sudo 
and running commands as a root user. 
3 S Take the command 
line back in time 

Now how did that super-long Docker 
command go? Can’t remember? Don’t 
worry. Just type history and all your 

- commands of the past are shown. You 
can also use the up arrow to cycle through 
your previous commands. Combine 
history with grep to find a certain line, 
e.g. history | grep docker. You can also 
press CTRL+R to do a reverse search of 
your command-line history. Just enter any 
word (such as ‘apt’ to search for the last 
command you entered with that word). 


i] 
3 g No, that isn’t a typo. Bang-bang 


(or !!) means ‘the last command you ran’. 
Why is this useful? Because of those times 
you forgot to prefix a command with sudo. 
Don’t retype the whole thing, just enter 
sudo !! and you’re set. Forget to pipea 
command? Try !! | <next command>. You 
can also combine ! with history to run 
commands. Just use ! with the number 

in history. e 


\ 
a a 





FEATURE ‘Might © 












3 Save time with aliases 
Find yourself typing the same 
commands over and over again? Create 
an alias! These are short cuts that you 
(or-vome(<sauatcmnoeCoyohi(smm Co) otemeroyoebenr-beLels 
into anything you want. Create or edit 
the file ~/.bashrc, then add them in like 
this: alias 1='1ls --color=auto'. A full 
Fequae(<Mer-boW of-m celeb ate U-Ums vut-t24 0) Bee) vy-LJ 1b Ken 


Software Leam Teach About us 


GB trower 


Books & magazines 





4 What's going on? 

If your Raspberry Pi is running 
hot or seems to be slow, it may be that a 
process has gone rogue and is spiralling 
out of control. There are a few ways to 
find out what the culprit is. The easiest is 
to run Task Manager from Accessories. If 
you don’t have a desktop, ps ax will list 
every process running and top will show 
processes in order of CPU usage. 
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4 Super-fast terminal 
Raspberry Pi OS desktop comes 
with a range of useful keyboard short cuts 
ike oX-) )omrolulex-immd o(-m [0] oMeLoyal=meLbb(ol.d ham (<r-Lel 
a terminal in a hurry? CTRL+ALTST will 
have your command line up in a second. 


4? Arrange your windows 


Desktop looking a little 
‘ crowded? There are a few short cuts 
that can help you get your windows in 
alignment. With a window focused, use 
CTRL+ALT+UP ARROW to set it full 
screen. CTRL+ALT+Left or Right Arrow 
will move it to half of the desktop. 


4 Take up all the screen! Soteare Bock maps 
If you’re working on a particular 
window and maybe you’re on a smaller 
screen, such as a Raspberry Pi touchscreen, 
you might find the menu bar is taking up 
useful space. Simply pressing ALT+F11 
with your chosen window focused will 
expand it to fill all the available screen. 
ALT+F11 again will reduce it down to its 
original size. 


4 Fast running 


Need to access the menu? 
Don’t waste time and energy with that 
mouse - just click the command key 
on your keyboard! That’s the Raspberry 
Pi logo on the official keyboard, or the 
Windows logo or Apple button on their 
respective keyboards. If you want to run 
a command quickly, just press ALT+F2 
to bring up a ‘run dialog’. 









4 ALT and click 
Did you know you can drag 
birateXeCoyi\acw-nmoltboCem onmoe) (cbnoteme(onisomaats 
ALT key and dragging any part of the 
window with the left mouse button? It’s 
handy for when a window ends up off 
of the side of the screen and you can’t 
access the menu bar. Also, you can resize 
a window by holding down the ALT key 
Evare mel bel abotcar-bolemetn-tescauerom nad omaat-palcdnls 
mouse button. Much easier than finding 
the corner of a window. 


ea. 
a 
a — 
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You're on mute! 

Yes, the application of 2020 can 
be coaxed into running on a Raspberry Pi. 
Zoom has a semi-hidden web app that 
will work with Chromium. When going to 
a meeting, click the link and an error will 
appear. Dismiss this and click ‘Click here’ 
until it says ‘start from your browser’. 
It’s a demanding application, so we 
recommend a Raspberry Pi 4 for this one. 
See ‘Working from home with Raspberry 
Pi’ (magpi.cc/workfromhome) or check 
out The MagPi issue #93 (magpi.cc/93). 


Printing 

Printing can be a tricky thing 

- to get working. Luckily, Raspberry Pi 
supports two key technologies to get 
things working. Firstly, CUPS is an 
Apple-driven, open-source project to 
bring printing to Linux-based systems. 
Secondly, IPP (Internet Printing 
Protocol) is a ‘common ground’ that 
most modern printers support if you 
find ARM-based drivers are unavailable. 
Read ‘Printing at home from your 
Raspberry Pi’ (magpi.cc/printing). 





TTT 


Dashboards 

It’s perfectly possible to 
use Raspberry Pi 4 as a ‘daily driver’ 
workstation. However, if you’re using 
something a bit more powerful, why not 
set up a Raspberry Pi dashboard? Use 
open-source projects such as Grafana to 
create charts, alerts, and more. Combine 
with a Raspberry Pi touchscreen and case 
for a beautiful sidekick to your PC. See 
The MagPi #98 for a guide to building a 
portable Raspberry Pi with a touchscreen. 


Home automation 

The excellent Home Assistant 
(available as an SD card image for Raspberry 
Pi) allows web-based control of a huge 
range of internet-connected devices. 
Perfect for creating the right lighting and 
temperature for your home office. If you’re 
(efoyaYel=ymol-relr-1ofoleum-bime]ot-l liavameeyanloynat-mum staal 
a Pimoroni Enviro+ for particle monitoring. 
See ‘Home of the future’ in The MagPi 
issue 104 (magpi.cc/104). 
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LibreOffice 
The LibreOffice suite has 

come on in leaps and bounds over 

the past few years. This has become 

a serious contender in the world of e 

office applications. Word processing, 

spreadsheets, databases, presentations, 

and more for free. The entire collection is * 

installed with a ‘Recommended Software’ 

Raspberry Pi OS image or within a few 

clicks on the desktop. ™ 


Sg 
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K.G. 
Orphanides 





K.G. is a writer, 
maker of 

odd games, 

and software 
preservation 
enthusiast. Their 
family fully 
supports the idea of 
an arcade machine 
in the living room. 


@KGOrphanides 


Build an arcade machine: 
Assemble your cabinet 


Once your arcade cabinet kit arrives, it's time to put everything together 


arcade cabinet, fit controls, and mount 

a monitor. You should follow the video or 
written assembly instructions for the model 
you buy, but we’ll go through the process so 
you know what to expect and how to handle the 
awkward bits. 

Kits don’t necessarily come with the screws 
and bolts you’ll need to attach parts such as 
speakers, speaker grilles, and monitors, so 
check that you have all the hardware you’1l 
need before you start. 

Our cabinet is an Omniretro Bartop Arcade 
King with a stand (magpi.cc/kingbartop), 
made of 16mm black melamine laminate, and 
we are using a 24-inch monitor. 


[ n this tutorial, we will assemble an 








Lay out your parts 

MDF and melamine laminate are light, 
cheap, and sturdy when assembled, but can be 
susceptible to damage if dropped or pivoted hard 
on an edge or corner. 

Make some space and put down towels to 
protect the cabinet parts and your floor from one 
another. If your unit consists of a separate bartop 
and stand, build them one at a time. Read or 
watch the manufacturer’s instructions and make 
sure that you have all parts, fixings, and tools to 
hand before you start. 
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Preparation 

Assembly varies from brand to brand. If 
access to the assembled cabinet is restrictive, you 
may have to fit your buttons and joystick to it before 
you put it together. 

Similarly, attach speakers to the inside of the 
marquee bottom and speaker grilles to the outside 
before you assemble the cabinet. If you’re working 
with laminate, mark up the screw positions through 
their holes with a paint pen and use a3mm bit to 
drill pilot holes. 

If you’ve already decided on your marquee, control 
panel and bezel graphics, your life will be easier if you 
apply these to their acrylic sheets before assembly 
(we'll be looking at this in detail in a later tutorial). 











™ Put down towels to protect 
the cabinet parts and your 
floor from one another @ 





Assembly 
If you’re comfortable with self-assembly 
furniture, an arcade cabinet shouldn’t present 
too much trouble, but a second person can be 
helpful for fitting and moving awkward parts. 
Ours has a control panel with a hinged access 
door beneath it, so we attached this hinge first 


MéigPi 


Top Tip 
Snap-out 


Snap-in buttons 
can be hard to 
remove without 
damage. The 
ButterCade 
Snap-out tool 
for push-buttons 
(magpi.cc/ 
snapout) is a 
plastic device to 
help with this. 


You'll Need 


Screwdrivers, 
spanners, Allen 
keys, crimping tool 


It's a good idea to fit your speakers Cordless drill 
and grilles before assembling the Drill bit set. 
cabinet, but it's possible, if fiddly, Screwdriver 
to do it afterwards bits, drill bits, 


countersinks, 
tank cutters 


Additional bolts, 
screws, female 
spade connectors 


(to mount 
components) 
AV (<M at Wem olUl me rtaavelelKollave melaice) Dremel 
idat-M-te (e [ey md al-Mer-1e)|a(-1male mre) (recommended) 
protect them, loosely secured and 3mm drill 
Zita Msi Kclalet-lgeme(olble)l-mr-j(o(-te k=) ol—) Paint pen (silver 
at the ends. We'll re-secure this if you have black 
Fe) ce) oL-Ta NVR Lar me(-revole- lil ale M tater Le) laminate, black 
for MDF) 
Old towels 


or sheets to 
protect parts 


Foam cleanser and 
microfibre cloths (to 
clean your cabinet 
and acrylics) 
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A The underside of a 
Sanwa JLF-TP-8YT 
joystick. Note the 
e-clip securing the 
central shaft 





Warning! 
Mains electricity 
& power tools 


Be careful when 
handling projects 
with mains electricity. 
Insulate your cables 
and disconnect power 
before touching them. 
Also, be careful when 
using power tools during 
this build. 


magpi.cc/drillsafety 
magpi.cc/ 
electricalsafety 





then set the panel aside. We then attached the 
hinge for the bartop’s rear access door and base, 
ined this part up with the cabinet’s hood-like 
top, and bolted all of these parts to one side 
panel laid on top of them. 
Lining bolts up with pre-drilled holes for this 
kind of build can be fiddly. If you have trouble, 
screw the bolts through the side panel until 
they’re protruding, and use them to help find the 
correct positions. 











The control panel 

With one side now in place, slide in the 
control panel and bolt it to the same side as the 
other parts. Next, attach the marquee bottom 
that houses the speakers, which should already be 
mounted at this point. 

With this model, we then close the latch on 
the rear access door and carefully flip the entire 
cabinet over onto the now-secure side panel. This 
is the best time to slide the marquee and screen 
acrylic panels into place. If you’ve not already 
applied graphics to them, leave their protective 
film on — it’s easy to peel off later. 

We now position the second side panel. We 
recommend again screwing in the bolts until they 
just protrude from the opposite side to help you 
lower the panel securely and accurately onto its 
pre-drilled holes. 





Feel the power 

Drill a hole at the back of your bartop and 
run the power bar’s cable out through it to 
connect directly to a plug socket. 
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Some suppliers will wire a socket and bar for 
you, but note that international plug standards 
differ. Use a plug bar that can be surface-mounted 
inside of the cabinet. 

While you’ re back there, cut a hole to 
accommodate a booted Ethernet cable or, more 
tidily, a screw-down Ethernet extension port. This 
will make Steam Link game streaming easier. 


Extending your shaft 

If your cabinet is over 16mm thick, you’ll 
want a longer than standard joystick shaft. 
Shafts are easy to swap, but watch out for parts 
dropping out. 

Like most sticks, our Sanwa JLF-TP-8YT’s shaft 
is held in place at the bottom by an e-clip. Hold 
the unit upside down, press on the bottom of the 
shaft with your thumb, and use a small flat-head 
screwdriver in your other hand to pull the clip off, 
using the slots in it. Pull the old shaft gently out 
from the top and push the new one in, carefully 
setting the pivot at the top and the spring and 
black plastic actuator at the bottom into place. 

Use a thumbnail to depress the actuator and 
slide the e-clip back into place. You can also use 
pliers or your screwdriver to help push it on. 
For a demonstration, see this YouTube video on 
changing joystick shafts: magpi.cc/joystickshafts. 








A To fit the VESA mount, place the cabinet face-down, then put the 
mounted monitor face-down on the front acrylic screen. Use a tape 
measure to help with positioning 





Cable tidy 





Cable lacing is a cable management technique 
where a nylon cord is used to bind wires together. 
It can be used to create incredibly neat builds, like 
this Arcade Stick by Gordon Hollingworth, Raspberry 
Pi's Chief Product Officer. 

Gordon learnt to cable-tidy this way as an 
apprentice for the MOD. “Tying the knot has to 
be done in a very specific way to avoid it looking 
untidy,” he tells us, “basically a capital offence 
in the apprenticeship!" Gordon's cables have 
knots regularly at 1cm, which keeps them smart. 
“We learnt this way because when you put a box 
into a plane or tank with some equipment in it, 
the vibration will shake apart pretty much any 
connection in the first hour. So this was the way it 
was done when electronics was more about wires 
connecting things than PCBs.” 

You can buy nylon cord and learn more from RS 
Components (magpi.cc/cablelacing). 











™ There's room to slide 
the screw slots on most 
joystick mounting plates @ 


07 Installing your joystick 
Two plastic dust washers come with Sanwa 

joysticks. Slide one onto the shaft before you mount 
the stick onto the underside of your control panel. 

When mounting your joystick, position it, mark 
up the position of the top right screw-hole on the 
joystick’s baseplate with a paint pen, and drill a pilot 
hole, being careful not to go all the way through. 

Attach your joystick by that screw, make sure 
it?s centred, and mark up the next hole or holes. 
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There’s room to slide the screw slots on most A Snap-in buttons 
A ; 5 ) : are held in place by 
joystick mounting plates, so you’ve got a bit of plastic clips. Connect 
wiggle room when it comes to the final fit. your DuPont GPIO 
o : : cables first to make 
Don’t worry too much about the orientation of internal wiring easier 


your joystick — position it where it won’t get in the 
way of the rest of your wiring. These are nominally 
designated up, down, left, and right positions; you 
can reassign these through wiring and in software. 

Finally, slide the second dust washer onto the 
shaft on the other side and screw the joystick’s 
ball on. 





World of buttons 

Snap-in buttons are ideal for thick wooden 
cabinets — plastic clips hold them in position 
inside the holes drilled for them. If you have an 
acrylic cover for your control panel, the buttons 
will hold it in place. 
It’s a good idea to attach your spade connectors to 
DuPont GPIO jumper cables before installing them, 


but you’ ll have to connect the shared ground cable To p TI p a 
after they’re in place. We wired GPIO to the right 





and shared ground to the left connector on each Foot the bill 
button, but it doesn’t matter which goes where. 
Where you have longer stretches between To help the 





cabinet stand on 
an uneven floor, 
you can fit four 
rubber feet to 
its underside. 


buttons, skip a connector on the ground chain to 
give yourself some extra cable to play with. 

You can label the end of each GPIO cable for later 
ease of connection to Raspberry Pi, but they’re not 
too hard to trace in most cabinets. 
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A Tomake it easier to 


ime up the sides of M If you find that you now 


your cabinet with their 


pre-drilled recieving ! : 
holes, partially screw in can t reach or fit g| part, 
each bolt untila couple 
f millimeti truck ! H 
onthefarside don't panic @ 


V Before construction, 
lay out the parts 

of your bartop on 
some old towels to 
protect them 
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Bolt screen to VESA mount 

Screen mounting can be fiddly. Most 
cabinets come with a baton-like wooden VESA 
mount that’s designed to be screwed into place 
from the inside. Start by bolting your monitor 
to the mount. Unless you’re working with a 
specialist cab designed for giant screens, you’ ll 
be using a 75mm or 100mm VESA mount. These 
usually take M4 bolts and have a depth of 10mm. 
So if bolts aren’t included, you’ ll need four, at 
a depth of 10mm plus the depth of your mount, 
although you can get away with shorter if you 
countersink them. 


Screw VESA mount to the cabinet 
Place the bartop face-down on the ground, 
protecting it with a towel. Take the protective 
plastic off the acrylic on the inside of the cabinet. 
Clean the acrylic with a microfibre cloth and anti- 
static foam cleanser 
Lay the monitor, attached to the cabinet’s 
VESA mount, face-down on the acrylic inside your 
cabinet. On the interior sides of the cabinet, mark 
up the position of the holes in the brackets on 
each edge of the VESA mount. Remove the mount, 
drill pilot holes, then replace and screw down the 
display and its mount. 
If your monitor has a front power button, you 
can use adhesive chair leg floor protectors as 
soft spacers to stop it from being pressed by the 
acrylic screen. 





Don't panic 

If you miss a stage in your build and find 
that you now can’t reach or fit a part, don’t panic. 
Speakers — and any other components in need of 
securing — can be attached internally using strong 
double-sided foam tape. 

Most external parts can be drilled and fitted in 
situ. If you want to deal with decoration last, then 
you can sometimes pop out your acrylic panels or, 
better, remove one side and reattach it. 

As you’1] see from the photos, we have 
temporarily applied U-moulding to protect the 
edges of the cabinet. U-moulding is easy to 
remove and refit or replace, assuming you don’t 
glue it down, but T-moulding is a little harder to 
remove cleanly. 

We’re now ready to connect Raspberry Pi. That 
will be covered in the next tutorial. {/ 
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Create GUIs with Python: 


Tic-tac-toe 


a basic GUI, let’s add some more 
programming logic behind the scenes to 
make your GUI work as the means of controlling 
a game of tic-tac-toe (also known as noughts 
and crosses). 
Create a new file with the following code: 


N ow that you have learnt how to make 


# Imports --------------- 
from guizero import App 


# Functions ------------- 


# Variables ------------- 


app = App("Tic tac toe") 
app.display() 


Create the board 

Let’s begin by creating the widgets which will 
make up the game board. A traditional tic-tac-toe 
board looks like the one shown in Figure 1. 

You’ll use buttons to represent each of the 
positions on the board, so that the player can click 
on one of the buttons indicating where they would 
like to move. To be able to lay out the buttons ona 
grid, let’s create a new type of guizero widget called 
a Box. 

A Box is acontainer widget. This means that it 
is used for containing other widgets and grouping 
them together. Add it to the imports at the top of 
your code: 


from guizero import App, Box 
Set the Box to have a grid layout and add it to 
your app — before the app.display() line, as with 


all widgets. 


board = Box(app, layout="grid") 
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| Figure 1 | 1 


A Figure 1A typical game of tic-tac-toe 


If you run your program at this point, you won’t 
see anything on the screen because the Box itself 
is invisible. 

Now let’s create the buttons to go inside it. 
You will need nine buttons in total, so instead of 
creating them individually, you can use a nested 
loop to generate them all automatically and give 
them co-ordinates. First, add PushButton to 
your list of widgets to import and then add this 
code immediately after the code for the board 
you just created. 


for x in range(3): 
for y in range(3): 
button = PushButton( 
board, text="", grid=[x, y], 
width=3 


Notice that there are two loop variables: x from 0 
to 2 and y from 0 to 2. As we iterate and generate 
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Tic tac toe via 





buttons, each button will be added to the board, 
which is the Box container you created earlier. 
The button will be given the grid co-ordinates 
x,y, Meaning that each button is neatly placed on 
a grid at a different position! 

Your code should now look like tictactoe1.py. 
The result of running it is shown in Figure 2. 

















Underlying data structure 

You might notice that when you create the 
buttons using a loop, you are creating nine 
DOWNLOAD buttons automatically and every single one is 


ticta ctoel.py THE FULL CODE: called button. How will you be able to refer to 


each of these buttons in the program? 


i ; The answer is that you need an underlying data 
» Language: hon y) magpi.cc/guizerocode 
dusgle ioe 3 structure to hold a reference to each button, and 


for this you will use a two-dimensional list. 
Let’s create a function which we can call to 


A Figure 2 A grid of nine buttons to play tic-tac-toe 

















001. # Imports --------------- 
Q02. from guizero import App, Box, PushButton 


0e3. clear the board. It is a good idea to do this ina 
004; # Functions. -=ssssHssss5s function so that you can reuse the code once the 
a5. 

006. # Variables ------------- game has been played to reset the board and 
00e7. allow the player to begin a fresh game. 

008. # App ------------------- « : . 
005, app: = dapl The tae toa In the functions section, add a new function 
e10. called clear_board. 


@11. board = Box(app, layout="grid") 


@12. for x in range(3): def clear _board(): 


e13. for y in range(3): 

e14. button = PushButton( 

gic praral, emee” 4 LEAS LA. Vly MA ERES) Your first job inside this function is to initialise 
e16. app.display() the data structure for the board. Let’s assume at 





this point you have not created any buttons, so you 
can initialise each position on the board as None 
— the element in the list now exists but does not 


ti cta cto e2? : py yet have a value. Add the following line, indented, 


to your function. 











» Language: Python 3 


new_board = [[None, None, None], [None, 
None, None], [None, None, None] ] 





001. # Imports --------------- 
Q0@2. from guizero import App, Box, PushButton 


003 Next, move the nested loop code from your app 
@@4. # Functions ------------- section into the clear_board function. Make sure 
205. def clear_board(): the indentation is correct. 
006. new_board = [[None, None, None], [None, None, None], [ : ’ : 

None, None, None]] Inside the inner (y) loop, add a line of code 
07. for x in range(3): to store a reference to each button at its x,y co- 
008. for y in range(3): F ig8 te - : ‘ 
209. Hdtton = eushnubben( ordinate position within the two-dimensional list 
e10. board, text="", grid=[x, y], width=3) so that you can refer to it later. 
e11. new_board[x][y] = button 
Q12. return new_board 
013. = new_board[x][y] = button 
014. # Variables ------------- 
a Finally, after the loops end, return the new_board 
Q@16. # App ------------------- : : 33 
@17. app = App("Tic tac toe") you have just created. Your function should look 
18. like this: 


@19. board = Box(app, layout="grid") 
@2@. board_squares = clear_board() 
e21. def clear_board(): 


@22 = app. display() new_board = [[None, None, None], 
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tictactoe3.py 








» Language: Python 3 





ee1. 
ee2. 
0e3. 
004. 
Qe@5. 
06. 


007. 
008. 


# Imports s=s-s=ssss<s-5< 
from guizero import App, Box, PushButton, Text 


# Functions ------------- 
def clear_board(): 
new_board = [[None, None, None], [None, None, None], [None, 
None, None]] 
for x in range(3): 
for y in range(3): 
button = PushButton(board, text="", grid=[x, y], 
width=3, command=choose_square, args=[x,y]) 
new_board[x][y] = button 
return new_board 


def choose_square(x, y): 
board_squares[x][y].text = turn 
board_squares[x][y].disable() 


# Variables ------------- 
turn = "X" 


Ht ADP casos osseesersocecs 
app = App("Tic tac toe") 


board = Box(app, layout="grid") 
board_squares = clear_board() 
message = Text(app, text="It is your turn, 


+ turn) 


app.display() 





[None, None, None], 
[None, None, None] ] 
for x in range(3): 
for y in range(3): 
button = PushButton( 
board, text="", grid=[x, 
y], width=3 
) 
new_board[x][y] = button 
return new_board 


In the app section, initialise a list called 
board_squares and set it to call the new function 
you just created. 


board_squares = clear_board() 


This variable will be assigned the value of the 
new_board you created within the function, which 
should be a blank board with nine buttons. Make 
sure that you create this variable after the code for 
creating the Box, otherwise you will be trying to 
add buttons to a container that does not yet exist. 
Your code will now resemble tictactoe2.py. 
Save and run the program and you should see an 
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Reset the game 





At the start, you wrote a function called clear_board. 
This may have seemed unnecessary at the time, but 
in actual fact it was thinking ahead to when the game 
has ended. Since tic-tac-toe is quite a short game, it is 
likely that someone might want to play more than one 
game in a row. 


Can you add a reset button to your game, which only 
appears once either someone has won the game, 

or the game was a draw? The button should call the 

clear_board function and reset the turn variable as 
well as the message reporting whose turn it is. 


Hint: You will need to check the guizero documentation 
to find out how to hide and show widgets, so that your 
button is not visible all of the time during the game. 


Hint: Create a new function which takes care of 
everything you need to do to reset the game, and call 
that function when the reset button is pressed. Don't 
forget that in your function you'll need to specify some 
variables as global. 





identical result to the one you had at the end of 
the last step, but now you have a hidden two- 
dimensional list data structure to let you reference 
and manipulate the buttons. 

If you want to see what your 2D list looks 
like, you could add a print command to print the 
board_squares list: print(board_squares). You 
should then see nine lots of [PushButton] object 
with text "" appear in the shell. 


Make the buttons work 
At the moment, your buttons don’t do anything 
when you press them. Let’s make a function to 
attach to the button, so that when it is pressed, the 
button displays either X or O depending on which 
player chose it. 

First, create a variable in the variables section to 
record whose turn it is. You can choose to start with 
either player, but we will choose to start with X. 


turn = "xX? 


This now means that you need to display on the 
GUI whose turn it is (Figure 3) so the players 
don’t get confused. Add Text to your list of 
widgets to import: 


from guizero import App, Box, PushButton, 
Text 





tictactoe4.py 





» Language: Python 3 








V Figure 3 Let your 


ee1. 
ee2. 
0e3. 
004. 
ee5. 
ee6. 


0Q7. 
ee8. 


# Imports --------------- 
from guizero import App, Box, PushButton, Text 


# Functions ------------- 
def clear_board(): 
new_board = [[None, None, None], [None, None, None], [None, 
None, None]] 
for x in range(3): 
for y in range(3): 
button = PushButton(board, text="", grid=[x, y], 
width=3, command=choose_square, args=[x,y]) 
new_board[x][y] = button 
return new_board 


def choose_square(x, y): 
board_squares[x][y].text = turn 
board_squares[x][y].disable() 
toggle_player() 


def toggle player(): 
global turn 


if turn == "X": 
turn = "0" 
else: 
turn = "X" 
message.value = “It is your turn, “ + turn 


# Variables ------------- 
turn = "X" 


# App ------------------- 
app = App("Tic tac toe") 


board = Box(app, layout="grid") 
board_squares = clear_board() 
message = Text(app, text="It is your turn, 


+ turn) 


app.display() 


Then add a new Text widget in the app section to 
display the turn. 


message = Text(app, text="It is your turn, 


players know "+ turn) 
whose turn it is 


Tic tac toe va xX 




















Itis your turn, X 
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Move to the functions section and create a new 
function called choose_square. 


def choose_square(x, y): 


You will notice that this function takes two 
arguments — x andy. This is so that you know 
which square on the board has been clicked. 

Add the following code (indented) inside the 
function to set the text inside the button that was 
clicked to the symbol of the current player, and then 
disable the button so it cannot be clicked on again. 





board_squares[x][y].text = turn 
board_squares[x][y].disable() 


Finally, connect this function to the button. Find 
this line of code inside your clear_board function: 


button = PushButton(board, text="", 
grid=[x, y], width=3) 


Modify it so that it looks like the line below: 


button = PushButton(board, text="", 
grid=[x, y], width=3, command=choose_square, 
args=[x,y]) 


You have added two things here. Firstly, 
you are attaching a command, just as before. 
When the button is pressed, the function with 
this name will be called. Secondly, you are also 
providing arguments to this function, which are 
the co-ordinates x and y of the button which 
was pressed, so that you can find that button 
again in the list. 

Your program should now look like 
tictactoe3.py. Save and run it. You will now be 
able to click on a button and it will change to an 
X. Unfortunately, in this version of the game it is 
permanently X’s turn! 


Alternating between players 

Once one player has taken their turn, the turn 
variable should toggle to be the other player. Here 
is a function which will toggle from X to O and 
vice versa. 


def toggle player(): 
global turn 


if cunne= 1X": 
‘CUP =: 2Or 
else: 
‘cuPh = “XK” 
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tictactoe5.py 





» Language: Python 3 








@01. # Imports --------------- 041. ) and board_squares[2][2].text in ["X", "O"]: 
@@2. from guizero import App, Box, PushButton, Text 042. winner = board_squares[2][0] 
003. 043. 
O04. # Functions ==-=-s+---+--+ 044 # Horizontal lines 
@@5. def clear_board(): 045 elif ( 
006. new_board = [[None, None, None], [None, None, 046. board_squares[0][@].text == 
None], [None, None, None]] board_squares[1][@].text == board_squares[2][0].text 
007. for x in range(3): 047. ) and board_squares[2][0].text in ["X", "O"]: 
ee8. for y in range(3): 048. winner = board_squares[0][@] 
e0e9. button = PushButton(board, text="", 49 elif ( 
grid=[x, y], width=3, command=choose_square, 50. board_squares[@][1].text == 
args=[x,y]) board_squares[1][1].text == board_squares[2][1].text 
e10. new_board[x][y] = button e51. ) and board_squares[2][1].text in ["X", "O"]: 
11 return new_board @52 winner = board_squares[0][1] 
@12 @53 elif ( 
13 def choose_square(x, y): 54. board_squares[@][2].text == 
e14. board_squares[x][y].text = turn board_squares[1][2].text == board_squares[2][2].text 
e@15 board_squares[x][y].disable() @55. ) and board_squares[2][2].text in ["X", "O"]: 
16 toggle_player() 56. winner = board_squares[@][2] 
17 check_win() 57. 
18 58. # Diagonals 
19 def toggle player(): @59. elif ( 
e2e. global turn 60. board_squares[9][@].text == 
@21 if turn == "X": board_squares[1][1].text == board_squares[2][2].text 
Q22 turn = "0" 061. ) and board_squares[2][2].text in ["X", "O"]: 
@23 else: 062. winner = board_squares[0][@] 
024. turn = "xX" 063. elif ( 
25 message.value = “It is your turn, “ + turn 064. board_squares[2][9].text == 
26 board_squares[1][1].text == board_squares[@][2].text 
@27 def check_win(): @65. ) and board_squares[@][2].text in ["X", "O"]: 
028. winner = None 066. winner = board_squares[®][2] 
Q29 067. 
030. # Vertical lines 068. if winner is not None: 
Q31 if ( 69. message.value = winner.text + " wins!” 
@32 board_squares[0][9].text == e70. 
board_squares[@][1].text == board_squares[@][2].text @71. # Variables ------------- 
33 ) and board_squares[@][2].text in ["X", "O"]: @72. turn = "x" 
34. winner = board_squares[@][0] 073. 
@35 elif ( @74. # App ------------------- 
36 board_squares[1][@].text == @75. app = App("Tic tac toe") 
board_squares[1][1].text == board_squares[1][2].text 076. 
037 ) and board_squares[1][2].text in ["X", "O"]: 077. board = Box(app, layout="grid") 
038 winner = board_squares[1][@] @78. board_squares = clear_board() 
@39 elif ( @79. message = Text(app, text="It is your turn, " + turn) 
e4e. board_squares[2][@].text == e8e. 
board_squares[2][1].text == board_squares[2][2].text @81. app.display() 

Add the code in your functions section. Notice the once you have set the text and disabled the button. 
first line in the function: global turn. You need to Your code should now resemble tictactoe4.py. Save 
specify this so that you are allowed to modify the and test the program again and you should find 
global version of the turn variable, i.e. the one you that you can click squares and they will alternately 


already created. 
will create a local variable called turn and 


If you don’t specify this, Python 


modify 


that instead, but that change won’t be saved once 





the function exits. 
You also need to make sure that the Tex 





t widget 


accurately reports the current player’s turn. After 
the if/else statement in the toggle _ player function, 


update the message like this: 


message.value = "It is your turn, 


"+ turn 


Go back to your choose_square function and call the 
toggle player function — with toggle player() — 
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be designated either X or O. 


Do we have a winner? 
Finally, you need to write a function which will check 
whether there is a row, column, or diagonal of three 
Xs or Os, and if so will report the winner of the game. 
Although it seems very inelegant, by far the 
easiest way to check if someone has won is to hard- 
code the checks for each vertical, horizontal, and 
diagonal line individually. 
The following code is for one vertical line, one 
horizontal line, and one diagonal - can you add 
the rest? 





def check_win(): 
winner = None 


# Vertical lines 
if ( 
board_squares[@][@].text == board_ 
squares[@][1].text == board_squares[@][2].text 
) and board_squares[@][2].text in ["X", "O"]: 
winner = board_squares[0][@] 


# Horizontal lines 
elif ( 
board_squares[@][@].text == board_ 
squares[1][@].text == board_squares[2][@].text 
) and board_squares[2][@].text in ["X", "O"]: 
winner = board_squares[0][@] 


# Diagonals 
elif ( 
board_squares[@][0].text == board_ 
squares[1][1].text == board_squares[2][2].text 
) and board_squares[2][2].text in ["X", "O"]: 
winner = board_squares[0][@] 


Notice that the function begins by creating a 
Boolean variable called winner. If by the time 
the long if/elif statement has been executed, 
the value of this variable is True, you know that 
someone has won the game. 

After adding the remaining winning line 
checks, add some code at the end of the function 
to change the display message if there has 
been a winner: 


if winner is not None: 


message.value = winner.text + " wins!" 
You now need to make sure that this function 
is called each time an X or O is placed, which 
corresponds to any time a button is pressed. Add 
a call to check_win at the end of the choose_square 
function, just in case the square that was chosen 
was the winning square. 

Your program should now look like 
tictactoe5.py. Run it and test the game. If 
you wrote the tests in the check_win function 
correctly, you should find that the game detects 
correctly when a player has won. 


Draw game 

At the moment, the game will allow you to continue 
playing even after it has been won, until all of the 
squares are selected. It will also not tell you if the 
game was a draw. You could stop at this point, but if 
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Global variables 





It is arguably a bad idea to use global variables because if you have many 
functions in a large program, it can become extremely confusing as to which code 
modifies the value of a variable and when. In a small program like this, it is not too 


difficult to keep track. 


Remember that it is possible to read and use the value of a global variable from 
inside a function without declaring it global, but in order to modify its value you 
will need to explicitly declare this. The functions in this program (and most GUI 
programs in this tutorial series) are actually modifying the values of your widgets 
as global variables. For example, when someone wins the game, you set the value 


of the message to display who won: 


message.value = winner.text + " wins!" 


In this example, message is a global variable. So how can we modify its value 
without declaring it as global? The answer is because we are using a property 
of the message widget, the property called value. Essentially what this code is 
saying is “Hey Python, you know that widget over there called message? Well, 
could you modify its value property please?” Python will allow modification 
through object properties in the global scope, but it won't allow you to directly 


modify the value of a variable without declaring it global. 





you really want to put the icing on the cake, adding 
a few more little touches could make your game 
more polished. 

First, let’s add some code to detect whether the 
game is a draw. The game is a draw if all of the 
squares contain either an X or an O, and no one has 
won. In the functions section, create a new function 
called moves_taken: 


def moves_taken(): 


Yow’re going to use this function to count the 
number of moves which have been made, so 
let’s start a variable to keep count, initially 
beginning at o. 


def moves_taken(): 
moves = @ 


Now, remember when we created the 
board_squares, we used a nested loop to create all 
of the squares on the grid? We’re going to need 
another nested loop here to check each and every 
square and determine whether it has been filled in 
with an X or O, or whether it is blank. Add this code 
for a nested loop to the moves_taken function: 


for row in board_squares: 
for col in row: 


Inside the loop, we need to check whether that 
particular square is filled in with an X or an O. If it 
is, add 1 to the moves variable to record that square 
has been counted. 
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06-tictactoe.py 





» Language: Python 3 





Q@@1. # Imports --------------- 





@0@2. from guizero import App, Box, PushButton, Text board_squares[1][@].text == board_squares[2][0].text 
ee@3. 047. ) and board_squares[2][@].text in ["X", "O"]: 
@04. # Functions ------------- e48. winner = board_squares[@][@] 
@@5. def clear_board(): e49. elif ( 
006. new_board = [[None, None, None], e5e. board_squares[@][1].text == 
[None, None, None], [None, None, None]] board_squares[1i][1].text == board_squares[2][1].text 
007. for x in range(3): Q51. ) and board_squares[2][1].text in ["X", "O"]: 
008. for y in range(3): 52. winner = board_squares[@][1] 
ee9. button = PushButton(board, text="", 053. elif ( 
grid=[x, y], width=3, command=choose_square, 054. board_squares[@][2].text == 
args=[x,y]) board_squares[1][2].text == board_squares[2][2].text 
e10. new_board[x][y] = button @55. ) and board_squares[2][2].text in ["X", "O"]: 
@11. return new_board @56. winner = board_squares[0][2] 
Q12. 057. 
@13. def choose_square(x, y): 58. # Diagonals 
e14. board_squares[x][y].text = turn @59. elif ( 
@15. board_squares[x][y].disable() 060. board_squares[@][0].text == 
016. toggle_player() board_squares[1][1].text == board_squares[2][2].text 
17. check_win() 61. ) and board_squares[2][2].text in ["X", "O"]: 
e18. 62. winner = board_squares[0][@] 
@19. def toggle player(): 063. elif ( 
20. global turn 64. board_squares[2][@].text == 
e21. if turn == "X": board_squares[1][1].text == board_squares[@][2].text 
22. turn = "0" 65. ) and board_squares[@][2].text in ["X", "O"]: 
23. else: Q67. winner = board_squares[@][2] 
Q24. turn = "X" 068. 
e25. message.value = “It is your turn, “ + turn @69. if winner is not None: 
@26. 70. message.value = winner.text + " wins!” 
027. def check_win(): e71. elif moves_taken() == 9: 
Q28. winner = None 72. message.value = “It's a draw" 
@29. 073. 
@30. # Vertical lines e74. def moves_taken(): 
Q31. Af ( e75. moves = @ 
@32. board_squares[0][@].text == 076. for row in board_squares: 
board_squares[@][1].text == board_squares[@][2].text @77. for col in row: 
@33. ) and board_squares[Q][2].text in ["X", "O"]: @78. if col.text == "X" or col.text == "0": 
034. winner = board_squares[@][@] 080. moves = moves + 1 
@35. elif ( Q81. return moves 
36. board_squares[1][@].text == 82. 
board_squares[1][1].text == board_squares[1][2].text 083. 
037. ) and board_squares[1][2].text in ["X", "O"]: es4. # Variables ------------- 
038. winner = board_squares[1][@] eg5. turn = "Xx" 
@39. elif ( Q86. 
040. board_squares[2][@].text == 087. # APPeSSses ssa seer es 
board_squares[2][1].text == board_squares[2][2].text 088. app = App("Tic tac toe") 
e041. ) and board_squares[2][2].text in ["X", "O"]: e89. 
042. winner = board_squares[2][2] e9@. board = Box(app, layout="grid") 
043. e91. board_squares = clear_board() 
044. # Horizontal lines e992. message = Text(app, text="It is your turn, “ + turn) 
e45. elif ( e93. 
046. board_squares[0][0].text == e94, app.display() 
if col.text == "X" or col.text == "0": if winner is not None: 
moves = moves + 1 message.value = winner.text + " wins!" 
Finally, once the loops have finished, add a return # Add this code 
statement to return the number of moves taken. elif moves_taken() == 
message.value = "It's a draw" 


return moves 
Your code should resemble 06-tictactoe.py. When 





Now, call this function inside the check_win run, the game will now check whether nine moves 
function, to check for a draw. Add this code after have been taken; if they have, it will change the 
the code that checks for a winner: message to report that the game was a draw. fi] 
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How not to code: 
a guide to concise 
programming 


Updating a 22-year-old game brought Andrew face 


to face with some very poor coding practices 


v Aseries of ultrabombs 
blowing up a snake. 


AUTHOR 





A n 1998, at the age 
how to write game 


ANDREW GILLETT 


Andrew Gillett is a tutor and programmer who has 
worked on ten published games including RollerCoaster 
Tycoon 3, LostWinds 2, and Kinectimals. 


of 17, | was learning 
sin C. My first 


| attempt, the subtly titled DEATH, was 
not going well. The game was my take 
on Hardcore, a 1992 Atari ST game by 
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would also have involved making dozens of 
levels and many enemy types, which was looking 
like too big a task, especially as | was finding it 
hard to understand the intricacies of how the 
enemies in Hardcore moved. 

So | abandoned that game and decided to 
replicate a different one - 1994's MasterBlaster, 
a Bomberman-style game on the Commodore 
Amiga. MasterBlaster didn't have a single-player 
mode or bots, so there was no enemy Al to 
write. And the level was just a grid with randomly 
generated walls and power-ups - so there was 
no real level design involved. With those two 
hurdles removed, development went fairly 
smoothly, the biggest challenge being working 
out some of the subtleties of how character 
movement worked. 

The game, which | named Partition Sector, 
was finished in mid-1999 and spent the next 18 
years on my website being downloaded by very 
few people. In late 2018 | decided to do a quick 
update to the game and release it on Steam. 
Then | started having ideas, and ended up 
working on it, on and off, for two years. 

One of the biggest hurdles | came across 
when writing my first games was how to 
structure the code. | knew how to write a basic 
game loop, in which you update the positions 
of objects within the game, then draw the level 
and the objects within it, and then loop back to 











the start, ending the loop when the ‘game over’ 
criteria are met or the player has chosen to quit. 
But for a full game you need things like a main 
menu, submenus, going through a particular 
number of rounds before returning to the main 
menu, and so on. In the end, | was able to come 
up with something that worked, but looking back 
on my old code 20 years on, | could see many 
cases of absolutely 
terrible practice. While 
most of my time was 
spent adding new 
features, a lot of time 
was spent rewriting and 
restructuring old code. I'm going to share some 
examples from the original code so you don't 
make the same mistakes! 


AVOID REPETITION 

In the original Partition Sector code, when the 
player moved the analogue stick up to move 
up the screen, there was a section of code 
which checked for this and then applied the 
movement. This included checks such as: is the 
player currently piloting a remote-control bomb, 
and is there space for the bomb to move up? 

If so, apply the movement. If the player isn’t 
remote-controlling anything, check to see if 
there's space to move the player character up. 
This includes checks for either a wall or a bomb 





being in the way. If the player has the ghost 
power-up, they can walk through most, but not 
all, walls, So we have to check for that too. If 
the player's able to move, we move them up a 
small amount, then also do a small movement 
eft or right if they aren't fully aligned with the 
vertical lane they're moving in. If movement is 
blocked by a wall or a bomb, and the player has 
the ‘Strength’ power-up 





“I started havingideas,and — hich allows them to 
ended up working on it, on 
and off, for two years” 


push such things, we 
apply the push effect, 
first making sure there's 
a free space for the 
wall or bomb to be pushed into. Finally, if the 
player is blocked by a wall, we might apply what 
| call secondary movement to the left or right, 
moving the player in the direction of an available 
lane. There's also code for updating the walking 
animation. In total, the code for the player 
moving up was 155 lines. 





MOVEMENT LOGIC 

Having written this code, | then proceeded to 
copy and paste it three times, for the down, 
left, and right directions. This is extremely bad. 
The code for moving down was identical to the 
code for moving up, except that it was checking 
for blockages and applying movement in the 
opposite direction. The same was true of the > 
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Wireframe 


This tutorial first appeared 
in Wireframe, our sister 
magazine that lifts the 

lid on the world of video 
games. Every issue 
includes tutorials and 
in-depth interviews, along 
with news and reviews 

of the latest indie and 
triple-A games. 

To find out more, visit their 
website at wfmag.cc. 
Check out their 


subscription offers at 
wfmag.cc/subscribe. 


How not to code: a guide to concise programming magpi.cc 57 


WE Magri | TUTORIAL 





OTHER 
LANGUAGES 


Each programming language 
has its own way of giving 

you access to other code 

files — in C# and Java you 

can automatically use public 
classes from other files within 
the same project, while in 

C++ you have to use header 
files (with include guards or 
#pragma once) to declare 
shared functions and classes. 
When working in Python, 

note that it won't let you have 
circular imports — for example, 
writing import file2 in file1.py, 
and import file! in file2.py. 





> Snake Hunter 
mode. 
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eft/right code, except it checked and updated 
he X axis instead. One of the biggest issues with 
his code was that any change to the logic had to 
be applied four times - once for each direction. 
Besides the increased workload, every time | 
made a change, there was a risk that I'd forget 
0 apply it to one of the directions, in which case 
‘d end up with a character who obeyed different 
movement rules depending on which direction 
hey were moving. 

The solution was to create a function, move, 
with two integer parameters - xDir and yDir. 
A value of zero for either of these means ‘Don't 
try to move on this axis’, while values of -1 
or 1 correspond to moving up/left or down/ 
right. Each frame, | get 
the control inputs and 
call the function with 
the appropriate values. 
Inside move, instead of 
specifically checking for 





squares are 64x64 pixels, and the player moves 
at a speed of two pixels per frame. In the first 
(bad!) code example, the update method in the 


Player class has separate movement code for 


each direction. If we take th 
to move left, we only allow t 
there isn't a wall immediate 
check a single point, which 


e example of trying 
he player to move if 
y to their left. We just 


is halfway down the 
sprite on the Y axis, and just 


past its left edge on 


the X axis (in this example, the player's X and Y 





co-ordinates represent the 


op left of the sprite). 


We convert 


the selected pixel co 


co-ordinates and check for a wa 


-ordinates to grid 
| - in the GRID list 








at the top of 


the code, each row is represented 


by a string, where a space represents an 


“Experienced programmers 
recognise opportunities for 
reducing code duplication” 


empty square, while ‘X’ 
represents a wall. If the 
proposed new position 
is empty, we apply the 
movement. We then 
check to see whether 


a wal 
playe 


above, below, or to the left or right of the 
r, linstead work out which grid square the 


player would be in if they were to move in the 


the player is per 
horizontal lane. | 
the Y position, m 


fectly aligned with their current 
f not, we apply a small change to 


oving it in the direction of 


being 


centred in the lane. 


specified direction, then check to see if there’s 


a wal 





or bomb in that s 


code like this can some 


quare. Writing generic 
times be slightly harder 


than writing separate code for each specific 


case, but it’s a vital skill 


to practise. Part of what 


separates experienced and inexperienced 


In player.py 
code, there’s on 
which deals with 


in the second set of example 
ly one set of movement code, 


all four directions. You'll 
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the player movement speed. First, we set 


the 


The code in Figure 1 and Figure 2 shows two 
simplified recreations of the player movement 
code in Python. The second example has been 
split into multiple code files. In each case, grid 
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variables x_dir 


and y_dir to -1, 0, or 1 to indicate 





which direction 


(if any) the player is trying to 


move on each axis. It uses the Controls classes, 
which are explained later on. The game doesn’t 
allow for diagonal movement, so if the player's » 
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FIGURE1 


import pgzero, pgzrun 
WIDTH, HEIGHT = 576,320 


GRID = L'XXXXXXXXX', 
'X x, 
TREO, 
"x xX"; 
"XXXXXXXXX J 


class Player(Actor): 
def __init__(self pos): 
super().__init__('player', pos, 
anchor=('left', 'top')) 





def update(self): 
if keyboard. left: 
x = int(self.x) - 2 
y = int(self.y) + 64 // 2 
grid_x = x // 64 
grid_y = y // 64 


# The square ahead does not have a wall 

if GRID[grid_y][grid_x 
# Apply movement 
self.x -= 2 


# Lane alignment 
if y % 64 < 64 // 2: 


self.y t= 1 
elif y % 64 > 64 // 2: 
self.y -= 1 


if keyboard. right: 
x = int(self.x) + 64+2- 1 
y = int(self.y) + 64 // 2 
grid_x = x // 64 
grid_y = y // 64 
if GRID[grid_y][grid_x] == ' ': 
self.x += 2 
if y % 64 < 64 // 2: 
self.y t= 1 
elif y % 64 > 64 // 2: 
self.y -= 1 


if keyboard.up: 
x = int(self.x) + 64 // 2 
y = int(self.y) - 2 
grid_x = x // 64 
grid_y = y // 64 
if GRID[grid_y][grid_x] == ' ': 
self.y -= 2 
if x % 64 < 64 // 2: 
self.x += 1 
elif x % 64 > 64 // 2: 
self.x -= 1 


if keyboard. down: 
x = int(self.x) + 64 // 2 
y = int(self.y) + 64+2-1 
grid_x = x // 64 
grid_y = y // 64 
if GRID[grid_y][grid_x] == ' ': 
self.y += 2 
if x % 64 < 64 // 2: 
self.x += 1 
elif x % 64 > 64 // 2: 
self.x -= 1 


player = Player( (64,64) ) 


def update(): 
player .update() 


def draw(): 
screen.clear() 


for row_index in range(len(GRID)): 
for column_index in range(len(GRID[row_ 
index])): 
if GRID[row_index][column_index] != ' ': 
x, y = column_index * 64, row_index 
* 64 
screen.blit(' gridblock’,(x,y)) 


player .draw() 


pgzrun. go() 





FIGURE 2 


import pgzrun, pygame 

from shared import * 

from player import Player 

from controls import KeyboardControls, 
JoystickControls 


WIDTH, HEIGHT = 576,320 
controls = JoystickControls(0) if pygame. joystick. 
get_count() > @ else KeyboardControls() 


player = Player( (64,64), controls ) 


def update(): 
player .update() 


def draw(): 
screen.clear() 


for row_index in range(len(GRID)): 
for column_index in range(len(GRID[row_ 
index])): 
if GRID[row_index][column_index] != ' ': 
x, y = column_index * GRID_SQ_SIZE, 
row_index * GRID_SQ_SIZE 
screen.blit(' gridblock’,(x,y)) 


a 


player .draw() 


a 


pgzrun. go() 
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Figure 1: An example 
of bad code. Sure, it 
works, but look at all 
that duplication. 


Figure 2: An example 
of good code. Look 
how much more 
compact it is than 
the previous sample. 
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DIFFERENT 
CLASS 


An abstract class is one that 
cannot be instantiated — or in 
other words, you can't create an 
object based on it. Its purpose 
is to serve as a base class for 
other classes which implement 
the specified abstract methods. 





> Moving code into separate 
functions makes it easier to 
see the big picture. 


pressing keys for both axes at once, we ignore 
the up and down keys. If either x_dir or y_dir 
is non-zero, the player is trying to move. The 
variable horizontal exists purely for readability, 
and is set to True or False depending on 
whether the player is trying to move on the 

X axis. We calculate the centre position of the 
player, then work out which grid position we're 
going to check for a wall, based on the axis and 
direction. The function get_grid_pos is used 

to convert from pixel to grid co-ordinates. If 

no wall is present, we apply the movement by 
updating both the X and Y co-ordinates based 
on x_dir/y_dir multiplied by SPEED. Although we 
only want to move on one axis, the variable for 
the other axis will be zero, so no movement will 
take place, without the need for an if statement. 
Finally, for lane alignment, we work out the 
position we'd like the player to be aligned with, 
and the move_towards function, defined, above 
the Player class, ensures that they will move in 
the necessary direction, without overshooting 
the target position. 








SPLIT CODE INTO FUNCTIONS 


The game's original C code contained a function 
named playTheGame, which was over 1200 lines 
long. This function was called when the player 
selected Start Game from the main menu, and 
handled setting up and playing each round 

of the game. Within this function, the largest 
section of code was the main game loop, which 
included updating each player (primarily dealing 
with movement and the dropping of bombs), 
updating bombs and explosions, updating the 
walls which shrink in towards the centre of the 
level, and drawing everything to the screen. 





updatePlayers(); 
updateUncarriedFlags(); 
updateKOTH() ; 

updateBombs(); 
updateExplosions(); 
updateDeath(); 
updateShrinking() ; 
updateBattleRoyaleTeams(); 
updateRespawningWalls(); 
updateSnakeHunterSpawning() ; 
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> Don't forget that 
a finished game 
needs menus. 





It also checked to see if the round needed to 
end (because a player had won, for example). 
Apart from the code which updates bombs and 
explosions, none of this had been separated 
into separate functions. In the new version, 

the code and data for the game logic have 
been moved into a class named Game, and that 
class contains methods such as updatePlayers, 
updateBombs, updateShrinkingWalls, and so 

on. The code for the main game loop largely 
consists of calls to these new methods, making it 
shorter and more readable. 


SPLIT YOUR CODE 


The code for the 1999 version of the game 
consisted almost entirely of a single C++ file 
which was over 5500 lines long. At the time, | 
didn’t know how to split my code into multiple 
files. These days | try to keep code files as short 
as possible - preferably no more than 1000 
lines, although this isn't always possible. Ideally, 
each file should implement one class or module. 
The improved version of the Python code 
shows how to split your code into multiple files. 
The main file is maze_good.py which runs the 
game, and uses the from/import statements 
to load in other Python files. The Player class 
is contained in player.py, the keyboard and 
gamepad controls are contained in controls.py, 
and shared.py contains constants and functions 
which need to be accessible from multiple files. 


AVOID GLOBAL VARIABLES 


The original code featured many variables that 
needed to be accessed from multiple functions. 
For example, there was an array of players, 
mainly accessed from the main game function, 
but also used in functions for getting the sprite 
for the current animation frame, drawing the 
players on the screen, and several others. My 
solution at the time was to use global variables, 
which can be accessed from any function. 
Beginner programming courses advise you to 
minimise your use of global variables, as they 
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can make it difficult to keep track of where 
variables are changed. Another problem with 

his approach is that it can lead to old data 
persisting. When | created a new variable, | had 
o remember to reset it each time a new game 
is started, otherwise the value of that variable 
from the previous game would carry over to 

he new game. Usually this led to obvious bugs 
which were easily fixed, but occasionally it led 

o more subtle bugs which weren't noticed for 
some time. Encapsulating these variables inside 
he Game class solved this issue, as the game 
object is recreated at the start of each game, 
ensuring that all variables contained within it are 
automatically set to their default values. 











BEHAVIOUR AND CLASSES 


Each player needs one or more variables 
indicating which controls they are using. For 
example, one player may be using a particular 
controller; another player may be using the 
arrow keys; a third 
player might be using 
different keys. In the 
original code was a 
variable indicating if 
the player was using 
a keyboard or a controller, and a variable 
specifying their controller or keyset number. 
Each time | wanted to check whether a player 
was pressing their controls in a particular 
direction, | would first have to check which type 
of controls they were using, and then had to 
check the input for the relevant control type. 

A better approach is to have a class named 
Controls, which exists purely as a base class for 
other classes that implement specific control 
methods. The Controls class itself isn’t intended 
to be instantiated: it doesn’t represent any 








“The 1999 version of the 
game consisted almost 
entirely of a single C++ file” 
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particular control method, just controls in 
general. It specifies methods that its subclasses 
must override. In controls.py, the Controls 
class inherits from Python's aBc (abstract base 
class), and uses the @abstractmethod attribute to 
specify that any class inheriting from Controls 
must implement the methods get_x_dir 

and get_y_dir. The KeyboardControls and 
JoystickControls classes inherit from Controls 
and provide their own implementations of those 
methods. In the main file maze_good.py, 

we assign the player an instance of either 
KeyboardControls Or JoystickControls depending 
on whether any controllers are connected. 

The beauty of this system is the player code 
doesn't need to know anything about the 
different control methods, or even that a control 
method exists. All it cares about is having an 
object that it can call 
get_x/y_dir on. When | 
switched the game to 
using Steam's own input 
system for controllers, 

| created a new class 
called SteamInputControls. No changes needed 
to be made to the player code: | just had to give 
the players SteamInputControls objects instead of 
JoystickControls ones. 

Writing bad code is inevitable when you're 
starting out - even experienced programmers 
sometimes do it. You don’t have to write 
everything perfectly the first time, but if you 
learn from my mistakes and get into good habits 
early, you'll make your life a lot easier. ® 











Partition Sector is out now on Steam. 
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< King of the Hill mode 
features a scoring zone 
with flashing disco tiles. 


v Alist of C++ code files 
in the new version of 
Partition Sector. 


{1 Solution ‘psector’ (1 of 1 proyect) 

4 ath] psector 

#6 References 

© External Dependencies 

gil Header Files 

#8 Resource Files 

y> Source Files 

4 & Controls 
Db aes ControlsManager.cpp 
D ate JoystrckControls.cpp 
D ate KeyboardControls.cpp 
b a% SteaminputControls.cpp 

4 y Music 
b aes OggMusic.epp 
D ate VorceMusic.cpp 

D ate AccessibilityOptionscpp 

b a% EnumStrings.cpp 

b at Flag.cpp 

b ate Fonts.cpp 

Db ate Gamecpp 

DP t+ Keyboard.cpp 

b a Particlecpp 

b ut Player.cpp 

Db ate Primitives.cpp 

D ate Prector.cpp 
ODD psestorre 

b ate PSectorMenu.cpp 

b ate Skin.epp 

b ate Soundcpp 

D ate Spnittes.cpp 

b at Steamcpp 

b at Team.cpp 

> aes TimingManager.cpp 

dD ate Utilxepp 


avves 
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Halfacree 


With a passion 

for open-source 
software and 
hardware, Gareth 
was an early adopter 
of the Raspberry 
Pi platform and 
has written several 
publications on 

its capabilities 

and flexibility. 


@ghalfacree 


Raspberry Pi Pico 
reaction game 


Build a simple reaction timing game using an LED and 


push-buttons, for one or two players 


icrocontrollers aren’t only found in 
M industrial devices: they power plenty of 
electronics around the home, including 

toys and games. In this tutorial you’re going to 
build a simple reaction timing game, seeing who 
among your friends will be the first to press a button 
when a light goes off. 

The study of reaction time is known as mental 
chronometry and while it forms a hard science, 
it is also the basis of plenty of skill-based games 
— including the one you’re about to build. Your 
reaction time — the time it takes your brain to 
process the need to do something and send the 
signals to make that something happen — is 
measured in milliseconds: the average human 
reaction time is around 200-250 milliseconds, 
though some people enjoy considerably faster 
reaction times that will give them a real edge in 
the game! 

For this project you’ll need your Pico, a 
breadboard, an LED of any colour, a single 3300 
resistor, two push-button switches, and a selection 
of male-to-male (M2M) jumper wires. You’ll also 
need a micro USB cable, and to connect your Pico to 
your Raspberry Pi or other computer running the 
Thonny MicroPython IDE. 











A single-player game 

Start by placing your LED into your breadboard so 

that it straddles the centre divide. Remember that 

LEDs only work when they’ re the right way around: 

make sure you know which is the longer leg, or the 

anode, and which is the shorter leg, the cathode. 
Using a 330 Q current-limiting resistor, to protect 

both the LED and your Pico, wire the longer leg 

of the LED to pin GP15 at the bottom-left of your 
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Pico as seen from the top with the micro USB cable 
uppermost. If you’re using a numbered breadboard 
and have your Pico inserted at the very top, this will 
be breadboard row 20. 

Take a jumper wire and connect the shorter leg 
of the LED to your breadboard’s ground rail. Take 
another, and connect the ground rail to one of your 
Pico’s ground (GND) pins — in Figure 1, we’ve used 
the ground pin on row three of the breadboard. 

Next, add the push-button switch as shown in 
Figure 1. Take a jumper wire and connect one of the 
push-button’s switches to pin GP14, right next to 
the pin you used for your LED. Use another jumper 
wire to connect the other leg — the one diagonally 
opposite the first, if you’re using a four-leg push- 
button switch - to your breadboard’s power rail. 
Finally, take a last jumper wire and connect the 
power rail to your Pico’s 3V3 pin. 

Your circuit now has everything it needs to act 
as a simple single-player game: the LED is the 
output device, taking the place of the TV you would 
normally use with a games console; the push- 
button switch is the controller, and your Pico is 
the games console, albeit one considerably smaller 
than you’d usually see! 

Now you need to actually write the game. As 
always, connect your Pico to your Raspberry Pi or 
other computer and load Thonny. Create a new 
program, and start it by importing the machine 
library so you can control your Pico’s GPIO pins: 





import machine 
You’re also going to need the utime library: 


import utime 
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In addition, you’ll need a new library: urandom, with any kind of nested code, the handler’s code 5 
which handles creating random numbers — a key everything after the first line - needs to be 
part of making a game fun, and used in this game indented by four spaces for each level; Thonny will A. Figs wAciigie: 
to prevent a player who has played it before from do this for you automatically. player reaction game 
simply counting down a fixed number of seconds 
from clicking the Run button. def button_handler(pin): 
Next, set a pressed variable to False (more on this global pressed 
later) and set up the two pins you’ re using: GP15 for if not pressed: 
the LED, and GP14 for the push-button switch. pressed=True 
print(pin) 

pressed = False 

led = machine.Pin(15, machine.Pin.OUT) This handler starts by checking the status of the 

button = machine.Pin(14, machine.Pin.IN, pressed variable and then setting it to True to 

machine.Pin.PULL_DOWN) ignore further button presses (thus ending the 
game). It then prints out information about the pin 

In previous Pico tutorials, you’ve handled push- responsible for triggering the interrupt. That’s not 
button switches in either the main program or ina too important at the moment — you only have one Warning! 
separate thread. This time, though, you’ re going to pin configured as an input, GP14, so the interrupt 
take a different and more flexible approach: interrupt will always come from that pin — but lets you test oe 
requests, or IRQs. The name sounds complex, but it’s your interrupt easily. limiting resistor before 
really simple: imagine you’ re reading a book, page peeeett Pico your 
by page, and someone comes up to you and asks you ac Yo U ! | | nee d gd new | b rd ry! pecs et ag 
a question. That person is performing an interrupt . resistor in place, the best 
request: asking you to stop what you’re doing, Urandom, which handles ceeelreacera as 
answer their question, then letting you go back to ; work; the worst outcome 





is it could do the same to 


reading your book. creating random numbers your Pico 


A MicroPython interrupt request works in exactly 
the same way: it allows something, in this case the 


press of a push-button switch, to interrupt the main Continue your program below, remembering 
program. In some ways it’s similar to a thread, in to delete the indent that Thonny has 

that there’s a chunk of code which sits outside the automatically created — the following code is 
main program. Unlike a thread, though, the code not part of the handler: 





isn’t constantly running: it only runs when the DOWNLOAD 

interrupt is triggered. led.value(1) THE FULL CODE: 
Start by defining a handler for the interrupt. utime.sleep(urandom.uniform(5, 10)) 

This, known as a callback function, is the code led.value(@) 

which runs when the interrupt is triggered. As 





y) magpi.ce/github 
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This code will be immediately familiar to you: the 

first line turns the LED, connected to pin GP15, on; pressed = False 
A Figure2A the next line pauses the program, the last line turns led = machine.Pin(15, machine.Pin.OUT) 
two-player the LED off again — the player’s signal to push the button = machine.Pin(14, machine.Pin.IN, 


reaction game 


button. Rather than using a fixed delay, however, 
it makes use of the urandom library to pause the 
program for between five and ten seconds - the 
‘uniform’ part referring to a uniform distribution 
between those two numbers. 

At the moment, though, there’s nothing 
watching for the button being pushed. You need 
to set up the interrupt for that, by typing in the 
following line at the bottom of your program: 





button. irg(trigger=machine.Pin.IRQ_RISING, 
handler=button_handler) 


Setting up an interrupt requires two things: a 
trigger and a handler. The trigger tells your Pico 
what it should be looking for as a valid signal to 
interrupt what it’s doing; the handler, which you 


machine.Pin.PULL_DOWN) 


def button_handler(pin): 
global pressed 
if not pressed: 
pressed=True 
print(pin) 


led.value(1) 

utime.sleep(urandom.uniform(5, 10)) 

led.value(@) 

button. irg(trigger=machine.Pin.IRQ_RISING, 
handler=button_handler) 


Click the Run button and save the program to your 
Pico as Reaction_Game.py. You’ll see the LED light 
up: that’s your signal to get ready with your finger on 


defined earlier in you 


runs after the interrupt is triggered. 
In this program your trigger is IRQ_RISING: this 
is triggered when the pin’s 


means the interrupt 
value rises from low, 


I program, is the code which 


its default state thanks to 


the button. When t 
as quickly as you ca 


he LED goes out, press the button 
n. 


When you press the button, it triggers the handler 


code you wrote earli 


er. Look at the Shell area: you’ ll 


see your Pico has printed a message, confirming 


the built-in pull-down resistor, to high, when that the interrupt was triggered by pin GP14. You’ ll 


the button connected 


to 3V3 is pushed. A trigger 


also see another de 





tail: mode=IN tells you the pin was 





of IRQ_FALLING would do the opposite: trigger the 
interrupt when the pin goes from high to low. In 
the case of your circuit, IRQ_RISING will trigger as 


configured as an input. 


That 
game, 


message doesn’t make for much of a 
though: for that, you need a way to time the 





soon as the button is pushed; IRQ_FALLING would 
trigger only when the button is released. 
Your program should look like this: 


import machine 
import utime 
import urandom 
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player’s reaction speed. Start by deleting the line 
print(pin) from your button handler — you don’t 
need it any more. 

Go to the bottom of your program and add a new 
line, just above where you set up the interrupt: 


timer_start = utime.ticks_ms() 


This creates a new variable called timer_start and 
fills it with the output of the utime.ticks_ms() 
function, which counts the number of milliseconds 
that have elapsed since the utime library began 
counting. This provides a reference point: the 

time just after the LED went out and just before 

the interrupt trigger became ready to read the 
button press. 

Next, go back to your button handler and add the 
following two lines, remembering that they’ll need 
to be indented by four spaces so MicroPython knows 
they form part of the nested code: 








timer_reaction = utime.ticks diff(utime. 
ticks_ms(), timer_start) 

print("Your reaction time was 
milliseconds!") 


ay 


str(timer_reaction) + 


The first line creates another variable, this time for 
when the interrupt was actually triggered — in other 
words, when you pressed the button. Rather than 
simply taking a reading from utime.ticks_ms() 
as before, though, it uses utime.ticks_diff() —a 
function which provides the difference between 
when this line of code is triggered and the 
reference point held in the variable timer_start. 
The second line prints the result, but uses 
concatenation to format it nicely. The first bit 


™ Setting up an interrupt 
requires two things: a trigger 
and a handler @ 


of text, or string, tells the user what the number 
that follows means; the + means that whatever 
comes next should be printed alongside that string. 
In this case, what comes next is the contents of 

the timer_reaction variable — the difference, in 
milliseconds, between when you took the reference 
point for the timer and when the button was pushed 
and the interrupt triggered. 
inally, the last line concatenates one more 

string so the user knows the number is measured in 
illiseconds, and not some other unit like seconds 
or microseconds. Pay attention to spacing: you’ ll 

see that there’s a trailing space after ‘was’ and 
before the end quote of the first string, and a leading 
space after the open quote of the second string and 
before the word ‘milliseconds’. Without those, the 
concatenated string will print something like ‘Your 
reaction time was323milliseconds’. 


5. 


qT) 








= 











Your program should now look like this: 


import machine 

import utime 

import urandom 

pressed = False 

led = machine.Pin(15, machine.Pin.OUT) 

button = machine.Pin(14, machine.Pin.IN, 
machine.Pin.PULL_DOWN) 


def button_handler(pin): 
global pressed 
if not pressed: 
pressed=True 
timer_reaction = utime.ticks | 
diff(utime.ticks ms(), timer_start) 
print("Your reaction time was 
str(timer_reaction) + “ milliseconds!") 


Js 


led.value(1) 

utime.sleep(urandom.uniform(5, 10)) 

led.value(@) 

timer_start = utime.ticks_ms() 

button. irg(trigger=machine.Pin.IRQ_RISING, 
handler=button_handler) 


Click the Run button again, wait for the LED to go 
out, and push the button. This time, instead of a 
report on the pin which triggered the interrupt, 
you’ ll see a line telling you how quickly you 
pushed the button — a measurement of your 
reaction time. Click the Run button again and see 
if you can push the button more quickly this time 
— in this game, you’re trying for as low a score 

as possible! 








A two-player game 
Single-player games are fun, but getting your 
friends involved is even better. You can start by 
inviting them to play your game and comparing 
your high - or, rather, low — scores to see who has 
the quickest reaction time. Then, you can modify 
your game to let you go head-to-head! 
Start by adding a second button to your circuit. 
Wire it up the same as the first button, with one 
leg going to the power rail of your breadboard but 
with the other going to pin GP16 — the pin across 
the board from GP14 where the LED is connected, 
at the opposite corner of your Pico. Make sure the 
two buttons are spaced far enough apart that each 








player has room to put their finger on their button. 


Your finished circuit should look like Figure 2. 
Although your second button is now connected 


to your Pico, it doesn’t know what to do with it yet. 


TUTORIAL | Magri 


ReactionGame | magpicc | 65 


WE Magri | TUTORIAL 


Go back to your program in Thonny and find where 
you set up the first button. Directly beneath this 
line, add: 


right_button = machine.Pin(16, machine.Pin. 
IN, machine.Pin.PULL_DOWN) 


You’1l notice that the name now specifies which 
button you’re working with: the right-hand 
button on the breadboard. To avoid confusion, 
edit the line above so that you make it clear what 
was the only button on the board is now the left- 
hand button: 


left_button = machine.Pin(14, machine.Pin.IN, 
machine.Pin.PULL_DOWN) 


You’ll need to make the same change elsewhere 
in your program, too. Scroll to the bottom of 
your code and change the line that sets up the 
interrupt trigger to: 


left_button. irg(trigger=machine.Pin.IRQ_ 
RISING, handler=button_handler) 


Add another line beneath it to set up an interrupt 
trigger on your new button as well: 


right_button. irg(trigger=machine.Pin.IRQ_ 
RISING, handler=button_handler) 


Your program should now look like this: 


import machine 
import utime 
import urandom 


pressed = False 

led = machine.Pin(15, machine.Pin.OUT) 

left_button = machine.Pin(14, machine.Pin.IN, 
machine.Pin.PULL_DOWN) 

right_button = machine.Pin(16, machine.Pin.IN, 
machine.Pin.PULL_DOWN) 


def button_handler(pin): 
global pressed 
if not pressed: 
pressed=True 
timer_reaction = utime.ticks_ 
diff(utime.ticks ms(), timer_start) 
print("Your reaction time was 
str(timer_reaction) + 


fs 


milliseconds!") 


led.value(1) 
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utime.sleep(urandom.uniform(5, 10)) 

led.value(@) 

timer_start = utime.ticks ms() 

right_button.inrg(trigger=machine.Pin.IRQ RISING, 
handler=button_handler) 

left_button. irg(trigger=machine.Pin.IRQ RISING, 
handler=button_handler) 


Click the Run icon, wait for the LED to go out, 
then press the left-hand push-button switch: 
you’ ll see that the game works the same as before, 
printing your reaction time to the Shell area. Click 
the Run icon again, but this time when the LED 
goes out, press the right-hand button: the game 
will work just the same, printing your reaction 
time as normal. 

To make the game a little more exciting, you can 
have it report on which of the two players was the 
first to press the button. Go back to the top of your 
program, just below where you set up the LED and 
the two buttons, and add the following: 





fastest_button = None 


This sets up a new variable, fastest_button, and 
sets its initial value to None — because no button 
has yet been pressed. Next, go to the bottom of 
your button handler and delete the two lines which 
handle the timer and printing — then replace 

them with: 


global fastest_button 
fastest_button = pin 


Remember that these lines will need to be 
indented by four spaces so that MicroPython 
knows they’re part of the function. These two 
lines allow your function to change, rather than 
just read, the fastest_button variable, and set it to 
contain the details of the pin which triggered the 
interrupt — the same details your game printed to 
the Shell area earlier in the tutorial, including the 
number of the triggering pin. 

Now go right to the bottom of your program, 
and add these two new lines: 


lhile fastest_button is None: 
utime.sleep(1) 


This creates a loop, but it’s not an infinite loop: 
here, you’ve told MicroPython to run the code in 
the loop only when the fastest_button variable 
is still zero — the value it was initialised with at 
the start of the program. In effect, this pauses 


your program’s main thread until the interrupt 
handler changes the value of the variable. If 
neither player presses a button, the program will 
simply pause. 

Finally, you need a way to determine which player 
won — and to congratulate them. Type the following 
at the bottom of the program, making sure to delete 
the four-space indent Thonny will have created for 
you on the first line — these lines do not form part 
of the loop: 


if fastest_button is left_button: 
print("Left Player wins!") 

elif fastest_button is right_button: 
print("Right Player wins!") 


The first line sets up an ‘if? conditional which looks 
to see if the fastest_button variable is left_button 
— meaning the IRQ was triggered by the left-hand 
button. If so, it will print a message - with the line 
below indented by four spaces so that MicroPython 
knows it should run it only if the conditional is true - 
congratulating the left-hand player, whose button is 
connected to GP14. 

The next line, which should not be indented, 
extends the conditional as an ‘elif? — short for ‘else 
if’, away of saying ‘if the first conditional wasn’t 
true, check this conditional next’. This time it looks 
to see if the fastest_button variable is right_button 
— and, if so, prints a message congratulating the 
right-hand player, whose button is connected 
to GP16. 

Your finished program should look like this: 





import machine 
import utime 
import urandom 


pressed = False 

led = machine.Pin(15, machine.Pin.OUT) 

left_button = machine.Pin(14, machine.Pin. 
IN, machine.Pin.PULL_DOWN) 

right_button = machine.Pin(16, machine.Pin. 
IN, machine.Pin.PULL_DOWN) 

fastest_button = None 


def button_handler(pin): 
global pressed 
if not pressed: 
pressed=True 
global fastest_button 
fastest_button = pin 


led. value(1) 
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utime.sleep(urandom.uniform(5, 10)) 

led.value(@) 

timer_start = utime.ticks_ms() 

left_button. irg(trigger=machine.Pin.IRQ_ 
RISING, handler=button_handler) 

right_button. irg(trigger=machine.Pin.IRQ_ 
RISING, handler=button_handler) 


while fastest_button is None: 
utime.sleep(1) 

if fastest_button is left_button: 
print("Left Player wins!") 

elif fastest_button is right_button: 
print("Right Player wins!") 


Press the Run button and wait for the LED to go 
out — but don’t press either of the push-button 
switches just yet. You’ll see that the Shell area 
remains blank, and doesn’t bring back the >>> 
prompt; that’s because the main thread is stil 
running, sitting in the loop you created. 

Now push the left-hand button, connected to 
pin GP14. You’ll see a message congratulating 
you printed to the Shell - your left hand was the 
winner! Click Run again and try pushing the right- 
hand button after the LED goes out: you’ ll see 
another message printed, this time congratulating 
your right hand. Click Run again, this time with 
one finger on each button: push them both at the 
same time and see whether your right hand or left 
hand is faster! 

Now that you’ve created a two-player game, you 
can invite your friends to play along and see which 
of you has the fastest reaction times! i] 














Get Started with 
MicroPython on Raspberry Pi Pico 





For more physical computing 
projects to try on your 
Raspberry Pi Pico, grab a copy 
of the new book, Get Started 
with MicroPython on Raspberry 
Pi Pico. As well as learning how 
to use Raspberry Pi Pico’s pins 
as inputs and outputs, you'll 
build a simple game, measure 
temperatures, save and load 
data to your Pico's file system, 
and even make a burglar alarm 
for your room. Get Started with 
MicroPython on Raspberry Pi 
Pico is available now from 
magpi.cc/picobook. 
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Body Build series, 
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Raspberry Pi for 
Dummies, Raspberry 
Pi Projects, and 
Raspberry Pi Projects 
for Dummies. 
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V Figure 1 Configuration 
display on the head of 
the guitar 





Cheap Trills for all 


Add extra functionality and options to your Trill Guitar 


Raspberry Pi Pico controller, now we turn 

to what you need to do to make it play, 
not only like a proper guitar, but also one on 
which it’s easy to play preprogrammed songs. 


-| aving seen last month how to use a 





Guitar modes 

Our MIDI Guitar uses three modes: 
configuration, free play, and song play. The 
configuration mode is entered by changing the 
configuration / play switch, and it allows us to 
change a few parameters and to select what ‘set’ 
the guitar is configured to use. The sets are 
defined by a configuration file in Raspberry Pi 
Pico’s memory; this is easy to modify, as we shall 
see. Basically, the free play sets allow you to 
change the chords by touching a position, called a 
fret, on the bar sensor. Whereas the song play 
mode moves to the next chord with a single touch 
— see Figures 1, 2, and 3. 
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Trill library 

While we introduced the Python Trill 
library in The MagPi #102 (magpi.cc/102), this 
will not run directly under MicroPython because 
of the different I2C library used by the latter. 
In addition, the Pico development notes say 
that addressing non-existent I2C hardware 
sometimes locks up your Pico. Finally, Pico allows 
six different pairs of pins for each of the two 12C 
buses, and it can easily change the 12C speed. 
Therefore, we’ve written a Pico version of the 
Trill library to allow you to select the pins to use, 
along with the I2C speed, when you initialise the 
sensors. It is called pico_trill_lib.py. 





Installing the software 

First, install the OLED display drivers. To 
do this, open up Thonny with the guitar connected 
and press the Stop icon to get the Python prompt. 
Then go to menu Tools > Manage plug-ins, type 






A Figure 2 Free play 
display with selected 
chord in a box 


Figure 2 


} Caps 
Lock 
: 


Shift 
.@) 


Special action fret positions for 
configuration and song play 


‘ssd1360’ into the search window, then click 
‘Search on PyPi’. It will return with a list of 
possible matches; click on the ‘micropython- 
ssd1327’ option and then click ‘Install’. Open 
pico_trill_lib.py in Thonny, and choose ‘Save as...’ 
from the File menu, then click on the ‘Raspberry 
Pi Pico’ box to save it on Pico. Do the same with 
the guitarConfigure.txt file. Finally, load the 
midi_trill_guitar.py file and save this as main.py. 


Playing the guitar 

Connect your guitar to a MIDI sound 
generator, either directly or through a MIDI 
interface cable. Disconnect any USB connections 


House Rising Sun 








Normal free play frets used 
in addition to the stars 


and slide the power switch to ON. You will see 
the first set come up ‘Free play 1’; swipe across 
the square pad and you will hear the chord 

of A minor ring out. Note: if you swipe at the 
bottom, the sound will be quiet, but swiping 
across the top will produce full volume. See the 
effects of a diagonal swipe across the square pad. 
Tap your finger at any position to get just a single 
guitar string to sound. 


Star-spangled fretboard 

At this stage, we realised it would be a good 
idea to mark the points on the bar sensor that 
corresponded to each chord, to make it easy to 
pick out the point to press. So we slid our finger 
up and down the bar sensor so we got to a point 
that was equal distance between changing the 
chord up or down, and placed a sticker there. As 
there are some fret positions that have special 
uses in the song and configuration mode, we 
used stars for these positions. Figure 4 (overleaf) 
shows how we positioned these stickers. 











Changing sets 
The example configuration file contains 
other sets. To change the set, move the slide 
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You'll Need 


Dot and 
star stickers 
magpi.cc/stickers 


MIDI Trill Guitar 
magpi.cc/104 


Top Tip 


Left-hand 
guitar 


To make this 

a left-handed 
guitar, change the 
variable in line 31 of 
the code to True. 


Figure 3 Song play 
display: shows three 
lines and scrolls if 
there are more 
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Playing File type 0 


- Free Play 
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Fret 0 Fret 1 Fret 2 Fret 3 


Fret 4 


Fret 5 Fret 6 Fret 7 
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Playing File type 1 


Configuration mode 


A Figure 4 Fret position 
meanings and usage 


V Figure 5 File 
type O, free play 


configuration format 


Figure 6 File type 1, 
song configuration 
format 


- Song 


Start Chorus 


Increment Decrement 


switch from play to configure and then tap the 
bottom fret, silver star, to step through the sets. 
Note that the set selected only moves in one 
direction and loops round to the start after the last 
set is displayed. Moving the switch back to play, 
the guitar will now have a new set of chords for 
free play, or chord sequence for a song set. The 
parameters for the chosen set are also applied to 
the guitar. You can create your own sets by editing 
the guitarConfigure.txt file. 


File entry Meaning 


Free play 1, 12 
0,0 

0, 800 

24,0 

0,11 


POWHRPNND 


NOUWUBWNe 


File entry 
House Rising Sun, 18 


# first line name max 16 charactors & relitave link to next set 

# second line file type & MIDI Channel 

# third line capo value and sustain note time before sending note off message 
# fourth line voice change, bank LSB 
#fret number 0 - chord number Am 
#fret number 1 =- chord number C 
#fret number 2 - chord number D 
#fret number 3 - chord number F 
#fret number 4 - chord number E 
#fret number 5 - chord number G 
#fret number 6 - chord number Em 
#fret number 7 - chord number A 


For file type 0 
Free play 1 


Meaning 
# first line name max 16 charactors & relitave link to next set 
# second line file type & MIDI Channel (0 = channel 1) 
# third line capo value and sustain note time before sending note off message 
# fourth line voice change, bank LSB 
#info start of song = - chord number Am 
#information number - chord number C 
#information number - chord number D 
#info last in the line = chord number F 
#information number - chord number Am 
#information number - chord number C 
#info last in the line - chord number E 
#information number - chord number Am 
#information number - chord number C 
#information number - chord number D 
#info last in the line - chord number F 
#information number - chord number Am 
#information number - chord number E 


#info last in the line - chord number Am 
& end of song 


Line 1 


Line 2 
For file type 1 
Song file 


Line 3 


Line 4 


Information number 





A 
Start of chorus 
End of line 


Start of song 
End of song 
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Last Chord 


Next Parameter 





Next Chord 


Next Set 


07 Making your own sets 

Figure 5 shows the format of a free play set. 
These sets are blocks of data in a format known 
as a linked list. At the start of each set is a link 
to the next set; we use the number of lines to the 
next set. As song sets can be any length, a linked 
list is essential. Figure 6 shows a typical song set, 
where the first number on a line can have a special 
meaning and the second number is the chord 
number. An optional single chorus marker can be 
placed in a song file for those songs that end with 
several repeated choruses. 








Configuration parameters 

These are defined in the first four lines of a 
set entry, but you can temporarily override them 
by entering the configuration mode. The green star 
steps through all four options, while the red and 
yellow stars allow you to increment or decrement 
the values. A capo is a device that clamps over 
the neck of a guitar, holding all the strings down 
across a fret; this changes the key of the chords 
you play by, in effect, shortening all the strings. 
However, unlike a real guitar, here you can also 
have a negative value for the capo, which in effect 
lengthens the strings. 


Sustain 

The sustain parameter needs a bit 
of explanation. Figure 7 shows the normal 
development of a sound between a note-on and 
note-off message. But in order to make the guitar 
feel like a guitar, and not a keyboard, the note-on 
message is sent when a touch is removed, not 
when it is detected. This makes an enormous 
difference to how you play it. So, in order to 
send a matching note-off message, the software 
automatically sends it a certain time after the 
touch is released. This time is set by the sustain 
value, which is in milliseconds. 
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Attack iDecay Sustain Release 
Open strings — E A D G BG 
MIDI note number—-w 40 45 50 55 59 64 
First fret-——m 41 46 51 56 60 65 
Volume 
42 47 52 S7 61 66 
43 48 53 58 62 67 A 
Note On Note Off Normal Keyboard play 
Trill release a ein Tee Trill Guitar 
EE 7 
44 49 54 59 63 68 - Figure 7/ 
Time 
Fifth fret-—m 45 50 55 60 64 69 
Standard Guitar Tab Possible Trill Guitar chords 
Play open en 
46 51 56 61 65 70 
Don't play + Oe 
i hold down strings 
47 52 57 62 66 71 
Chords 
There are many hundreds of chords 
possible, but only 48 are defined in the software. Lower 0 45 50 57 62 66 MiDInotes 
You can add extra ones after line 92. The “A 30 45 50 57 62 66 MIDI notes 
relationship between MIDI note numbers and 
frets on a real guitar is shown in Figure 8. Chord these, and the chord numbers shown in lines 44 to | Figure 9 | 
patterns are normally shown as a tab, and this 92. We would recommend you also generate and 
needs to be translated into MIDI values; Figure 9 print out a text file showing the words, and chords, : 
shows how this is done. Note that some strings to use while you learn the song. = ae 
have an X above them, indicating that the string Sei and playing 
should not be plucked. If you place a zero here, a 
there will be no note sounded, but we prefer to add Figure 8 Guitar 
an extra note, normally the next chord root down. Strum or pick ee cl tie 
With the song mode, all you have to do is to 
touch one star at the right time to automatically A Figure 9 Converting a 
: ab chord notation to 
get the next chord. This leaves the other hand to MIDI note numbers 
Songs strum in time, or pick individual notes by tapping 
The internet is full of songs written in guitar your fingers. We found it sounds good whatever 
tab format, many of them for a limited number of single strings you tap — just tap in the correct 
chords — just search for ‘guitar strum songs for rhythm. You can also use a mixture of strumming 
beginners’. A guitar tab is a list of lyrics with the and tapping. We have found this is a great way for 
chord changes above each specific word, or part absolute beginners on the guitar to get good 
way through the word. It is quite easy to generate a results, and improvement can be rapid with a few 
song set entry in your guitarConfig.txt file using minutes’ practice. 
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#MonthOfMaking 


Fam 4 be 
SHOWCASE 


What did-readers of The MagPi get up 
to in March? By Rob Zwetsloot 


something, and show us! There are very 
few limits and rules, so we end up getting 
some cool stuff sent to us. 
We saw an amazing variety of stuff made by our 
community this year, so we thought it would be a 
great idea to show off what they’d made! 


- very March we put out a call - make 


mM We saw an amazing 
variety of stuff @ 


Remember, you can keep making and showing 
us what you’ve done any day of the year! We look 
forward to seeing what else the community makes 
over the rest of the year. 
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| soy ats! 


New look voice assistant 


This project looks very familiar - probably 
because it’s a Google AIY Voice Kit, like the one 
we gave away with issue 57 all those years ago. 
This one has had a bit of a paint job, so it has 
its own unique look and personality. We hope 
bsatoyot- Wald yoko elex-nne(On 


Edgardo Peregrino @sentairidernerd 






Pico MIDI Fighter 


Here comes a new challenger 


MIDI controllers are cool, programmable music 
boards. What makes this a MIDI Fighter? Well, 
the use of arcade buttons that you might find 
on a Street Fighter cabinet. They can take a hit, 
making for some excellent and frantic tunes. 


Liz aka Blitz City DIY magpi.cc/blitzcitydiy 








1SX=1 a Com -Vok-) Corel th-mer-lele(:) 
Air Quality Monitor 


Suitability to breathe-o-meter 





“Tn this project, I show you how to track the 

air quality (using public data from the popular 
PurpleAir Air Quality Sensors) and displaying it 
on a retro analogue gauge that shows the colour- 
coded Air Quality Index (AQI). It is built with a 
Raspberry Pi, a micro-servo, an RGB LED, anda 
ProtoStax Enclosure along with some Python.” 


‘Sridhar Rajagopal | @sridharajagopal 





Raspberry Pi Pico 
Lookup Display 


A tiny database Sa eee ge a: 


We were already pretty impressed by the ; . 
use of the tiny SSD1306 display on Pico, but aida process 7 
Edward went a step further and attached a tiny d be gooc 
wireless chip as well so that it can connect to 
the internet. This could make for a cool watch- 
style project. 


/Edwardd @ed_pi_ted 
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Software 
projects 
aes Hines 
clo Programming is 
: as much making 
as soldering 


Track your working environment 





Building the basics 





‘Brian Corteil @CannonFodder 
Cat detection system 


“Probably the easiest 4 Ry 
make ever. Pi Zero plus 
old webcam, MotionEyeOS 
software, Pushover app, 
and a Python script from 
The MagPi magazine, and 
hey presto, a cat detection 


Jesper E. Siig | @yesperenn system up and running 


#monthofmaking’. 


EU) tga.) @cumbiebob 

















Clumsy MIDI No strings attached 
“I've been playing with 

my #mt32pi synth (by 

@_dopefish_) to see what 

it can do.” 


diyelectromusic 


@diyelectromusic 


DD. @DDroboticsChick 





PNUhde}ap Taide} mele) ge(=ra Internet speed 
monitor 


“In this #MonthOfMaking, 

| built an internet speed 
monitor using Docker on 

a Raspberry Pi to figure 
out why my internet 

was so slow. Blog here: 
magpi.cc/speedmonitor.” 


| Aula-J [vem @Dansharpc 













Pi Day spigot 

Streaming an irrational number 

SM ob Kw key ol Moy mm aX exolo) (-k<}om 9) 0) (-Lel RMT MONS 
March ~ a tap that streams the digits of pi for Pi 
Day. It uses a Raspberry Pi, a ‘tap’, an optical water 
running illusion using some LEDs, and of course a 


scrolling display of all the digits of pi. The tap even 
works to slow down the stream - amazing. 


@bornachO 


This is one of the coolest 
projects we saw @ 










Temperature display 


Pico experiments 


Similar to Brian’s project, this one makes use 
of a classic seven-segment display to show 
the temperature readings. Pico can natively 
read analogue signals such as those from a 

Dr Footleg built this temperature sensor, unlike Raspberry Pi which 
robot and was featured requires some extra components to convert it. 


in issue 41 of HackSpace André Cléri t 
magazine (hsmag.cc/41). detalii Ormrmaster— 





a Wey ate Vals 


Super-charged robot 


Edgardo again, this time with a robot that 
he’s using as a base to make a ‘zero code’ 
$0) Xo} ap Koy ma coLenatex-y ap eat-1:<-sacm no Meco) UCoyiar-Uloyeteg 
to. We do quite like robots with tank treads, 
and this one also seems to have a series of 
hidden sensors for easier automation. 


Edgardo Peregrino 2 
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Alternate 
makes 


Making doesn't 
just have to be 


Raspberry Pi-based 
A wearable reborn 


Weather frame 

“| rebuilt a failed project 

from 2014 with some 

LED strips, an Espruino 

WiFi, a 3D-printed frame, 

and wooden case. Data 

comes from OWM API 
“Arijit Das @arijitioso and the six-day forecast is 

displayed with the colours at 

the bottom.” 


Maarten Canmaert 


@marzsman 





3D-printed art 

“3D Printing Art with 

Fusion360. | wanted to make Info-enclosure 
some decorative blank 

Eurorack panels and turned 

to 3D printing to do it.” 


Liz aka Blitz City DIY 


magpi.cc/blitzcitydiy 


Watch Liz design and print i 
some cool art and learn ‘Hexabitz pexabiz.com 


how to do it yourself here: 
magpi.cc/3dartprint 











Human-following robot 


Potion of Healing 
dice shaker 
“For #MonthOfMaking | 
decided to start a whole side 
business making and selling 
#DungeonsandDragons 

_Jitesh Saini @jiteshsaini10 gifts on Etsy. I've had some 
great sales and feedback for F ' 

= - Soe these Potions of Healing and A simple Pico bot 

”| | can't wait to design more! 

Each bottle contains four or 

eight four-sided (d4) dice, 

with instructions on how 

many to roll on the label.” 


Veer @alexjrassic 


You can still buy these 
from Alex's shop here: 


magpi.cc/potiondice Robert Wiltshire @astrotutor9 
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HQ Camera mod 


Ready for a close-up 


This is a simple and clean build that allows for 
taking great photos with the HQ Camera, and 
you can preview them on the big 7-inch display 
as you’re shooting. It can even be mounted on 
a tripod, which is quite fancy. 


‘Sridhar Rajagopal @sridharajagopal 





PiDay Pinball 


Virtual flipping on Raspberry Pi 





Virtual pinball has slowly been gaining traction 
over the years — VR pinball is just becoming a 
thing as well — so it was cool to see a build ona 
TV that uses a Raspberry Pi to power it. 


G25) orzrrreerr 


M You can still make very 
e{ale)manlialesmyiGamelame)(elais 
Raspberry Pi @ 





IW RURS Kor-) Mo) E-Valo mca Cole) 

Sit on it 

We notice an original Raspberry Pi in this 
setup, showing you can still make very cool 
things with an older model. Jonny here 
followed a guide to make his own, so if you 
fancy, you can too: magpi.cc/monotron. 


Jonny | @mcjonnyw 





DIY monitor 


Practical upcycling 


Rafa sent this one to us via email - he managed 

to use an old notebook as a screen for his 

Raspberry Pi, saving a lot of money in the 

PX 2S WINE ESS taCKng mySiCs process. “Not the cleanest solution, but it is the 
|] } | i q f F Enc cheaper and simpler one I found to maintain my 

3 olelk 5 Raspberry Pi as a main PC for a year.” 


i 


gh al alls 
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Grove Starter Kit _ 
for Raspberry Pi Pico 


> Grove > magpi.cc/grovestarter >» £TBA/ $43 








SIZE: 


56mm « 56mm 


PORTS: 

3 x analogue, 
3 « digital, 

2 x UART, 

2x 12C,1* SPI 


OPERATING 


VOLTAGE: 
3V3 7 5V 


The Grove Shield 
connected to a 
162 LCD and 
two sensors. Here 
the display is 
programmed to 
output light and 
sound values 


Explore the world of Raspberry Pi Pico electronics 
with this click-and-play kit. By Lucy Hattersley 


one of the fundamental joys of using a 

microcontroller such as Raspberry Pi Pico 
(magpi.cc/pico). The GPIO pins on Pico can be 
wired up to an array of sensors, buttons, LEDs, 
and displays enabling a wide array of projects. 

At the heart of the Grove Starter Kit for Raspberry 
Pi Pico is a Grove Shield ($4, magpi.cc/groveshield). 
This board has ten different Grove Connectors: 
three analogue ports, two digital ports, three UART 
ports, and four I2C ports. It also has a 3V/5V power 
switch to adjust the voltage output, and a six-pin 
SPI interface. 

Raspberry Pi Pico slots into the header on the 
Grove Shield and Grove parts are snapped straight 
into the white Grove connectors. This enables you to 
prototype projects quickly and easily. 


E xploring the world of electronics is 
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You will need to have soldered pins on to 
your Pico (or you can pick up a pre-soldered Pico, 
magpi.cc/picosoldered). But from that point on, 
you don’t need to solder parts or figure out circuits 
and jumper wires. You just connect the Grove part 
to the Grove Shield using one of the included Grove 
Universal 4-Pin cables (magpi.cc/grovecable). 
Grove itself says this “simplifies the learning 
system, but not to the point where it becomes 
dumbed down”. 

Each Grove cable has four wires: typically one 
for power, another for ground, and two for input 
and output (the exact nature of each wire depends 
on the part it’s connected to; you can read more at 
magpi.cc/groveinterface). 

This does, indeed, make it extremely easy to hook 
up components to Raspberry Pi Pico. And to that 





M For the sheer joy of 
attaching a component 
and getting it to work, this 
is hard to beat @ 


end, the kit comes with a wide range of parts to 
play with. There is an LED pack, RGB LED display, 
light sensor, sound sensor, rotary angle sensor, 
temperature and humidity sensor, passive buzzer, 
button, servo, mini fan (with DC motor), relay, and 
a 16x2 character LCD. 


Learning curve 

The Grove Shield for Pi Pico wiki page has a range 
of tutorials that use the parts found in the kit 
(magpi.cc/groveshieldwiki). 

The tutorials use all the parts found in the Starter 
Pack and give a good overview of what you can do. 
You typically need to download a Python module 
for each part. And analysing the code will give you 
a good overview of what each component can do. 
We programmed the LCD to respond to light and 
sound; a fan and servo movement detector; and 
played around with lights, buttons, and the relay. 

Thanks to the Python support files, introductory 
wiki tutorials, and the click-and-play nature of the 
kit, it is ridiculously easy to move from having an 
idea to getting it working. 


There is an argument that replacing the pure 
jumper wires and breadboard with a custom 
connector removes part of the learning curve. 

And it’s hard to take a prototyped circuit and wire 
components directly to Pico so you remain attached 
to the Grove Shield and its ecosystem of parts. But, 
for the sheer joy of attaching a component and 
getting it to work, this is hard to beat. Hl 





A. The Grove Shield for Raspberry Pi Pico has a range of ports that 
make it easy to click and connect components 
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A. The Grove Starter kit 


contains a range of 
Grove components 
and the Grove Shield 





Verdict 


It offers a painless 
way to attach 
components to 
Raspberry Pi Pico 
and play around 
with electronics. 
There's a 

huge range of 
components, 

and the 
documentation 

is good. 


9, 10 
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10 Amazing: 


Portable 
Raspberry 
Pi projects 


Take your Raspberry Pi with you 
for extra fun 


power. This makes it perfect for plugging in 

a portable battery and making your trips a bit 
more interesting. Here are some of the greatest ways 
to make your Raspberry Pi portable. 


2 aspberry Pi is small and requires very little 





4 Raspberry Pi 2Go portable 
workstation 





Making-to-go 


This compact design is great for making and testing on the go, 
especially with the built-in breadboard! 


magpi.cc/98 








4 Ruggedized Raspberry 
Pi Portable 





Apocalypse-ready 


When planning for many kinds of fictional apocalypse, 
people seem to always forget the tech part. This rugged 
laptop will help there and in the real world. 


magpi.cc/ruggedpi 





<PiBoy DMG 





Game Boy converter 


There are a few ways to turna 
Raspberry Pi into a portable handheld, 
but this all-in-one kit from PiBoy DMG 
is one of our recent favourites. 


$130 | magpi.cc/piboydmg 











4 Lunchbox Arcade Game 





Need food badly 


A quick go at Street Fighter on a lunch-break is a tradition in some offices, and 
this takes it a little step further by combining the two. 


magpi.cc/lunchbox 
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4 Portable Raspberry Pi 4 computer 





Recycled parts 


HackSpace magazine editor Ben Everard made this very quickly with some 
spare parts and a handmade wooden ‘case’ It does the job surprisingly well. 


hsmag.cc/24 





> Wearable time- 
lapse camera 





Conspicuous fast-motion 


Avery cool use of Raspberry Pi that 
lets you walk around and get a nice 
little time-lapse of your day. 


magpi.cc/timelapse 





4 mintyPi 





Incognito gaming 


Stuffing a Raspberry Pi Zero into a mints tin is an incredible accomplishment in 
itself, and mintyPi takes it a step further to be a whole game system. 


magpi.cc/mintypi 
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4 Raspberry Pi laptop 





Pocket power 


This tiny Raspberry Pi laptop from issue 74 is the whole package 
in one - there's even a rechargeable built-in battery! 


magpi.cc/74 








4 Becca Cam 





HQ Camera hack 


The recent HQ Camera is a powerful sensor with some great 
lenses. It's not a full camera, though, so Becca put it inside an 
old SLR. 


magpi.cc/beccacam 





> Raspberry Pi 
Zero AirPlay 





Music anywhere 


Need a portable speaker that 
anyone can control easily? This 
AirPlay speaker is simple and 
looks great. 


magpi.cc/airplay 
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Learn web development 
with Raspberry Pi 


Develop websites and internet-connected services with Raspberry Pi. By Lucy Hattersley 





BTML & CSS Modules 1& 2 


Code Club 


Web design, and web 





Price: 
Free 


magpi.cc/webdev1 


development, are great skills 
to have. Web design enables 
you to create websites; web 


up. Although, like many skills, it 


can take a lifetime to master. 
Absolute beginners should 
heck out these modules made 


development enables you to build 

the back-end server and integrate 

it with the many hardware and 

software features of Raspberry Pi. 
Many builds and coding 


c 
by Code Club. They walk you 
through HTML and CSS (the 
text and style code used at 

the heart of website design). 


Designed to keep kids interested, 


projects benefit from having a 
good website (either as part of 


the build, or as an accompanying 


help and documentation site). 
The good news is that web 
design is — at least in the early 


stages — remarkably easy to pick 





these lessons follow the form 
of a practical project, such 

as designing a wanted poster 
or displaying a recipe. Later 
lessons work up to creating an 
interactive pixel-art editor and 
animated graphics. 


The code is displayed and 
coded in an interactive online 
environment called Trinket 
(trinket.io). You can follow along 
with the web browser on your 
Raspberry Pi. 


es ryt 4? oe Petree @ 
aaa qs w BAe, 











Flick through these paper or PDF books 


WEB DESIGN WITH HTML & CSS 
Jon Duckett’s HTML and CSS book is 
a popular guide to web development. 
The books are highly visual, with 
artwork and photography being used 
to explain the concepts. A joy to read. 
magpi.cc/duckett 


RASPBERRY PI FULL STACK 

Dr Peter Dalmaris's guide to using 
Raspberry Pi is over 400 pages Long. It 
goes over setting up Raspberry Pi and 
an NGINX stack, before moving on to 
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data logging, charts, integration with 
database, and setting up a Raspberry 
Pi with Arduino and sensors. 
magpi.cc/elektorfullstack 


FULL STACK WEB 
DEVELOPMENT WITH 
RASPBERRY PI 3 

It's a little older, but Soham Kamani's 
book is still relevant, and covers 
setting up a network stack and 
running a Node server. Then you can 
extract data from the GPIO pins and 





sensors, and use this to create web 
pages displaying the data. 
magpi.cc/packtfullstack 


Raspberry Pi 
Full Stack 


RESOURCES | Magri 





a Raspberry Pi Full Stack Bookmark 


these 








Udem Once you have the basics The course uses a DHT22 10) 
of HTML and CSS, it is time sensor (magpi.cc/dht22) with we sites 
Price: to get serious about web an LED, push-button, and 
£60/$60 development. Few courses breadboard. With those in hand, There's no shortage 
magpi.ce/ offer the breadth and depth you set up Raspberry Pias an of websites about 
udemyfullstack ; : 
of Udemy’s Full Stack for NGINX web server and SQLite web development 
Raspberry Pi. This hands-on database, and use HTML and 
project is based on building an JavaScript to control everything. ———SEE——— 
Internet of Things application. It’s far more detailed eRe ees, 
than most web development Build projects. 
courses, and it is built on top of Earn certifications. 
Raspberry Pi hardware, which FS ep 
ena ni hr psredianet makes it ideal for our needs. i amar AAR As 





The course is paid for, but you y 
do get nine hours of video and Pep | 
a range of code resources. It’s : 


frequently on sale too, and 








keep an eye out for vouchers FREECODECAMP 
— ae (it’s currently on sale for £13 in There are lots of websites 
feqeemmeree == the UK). offering great content at cost, 


but freeCodeCamp does it all 
for free. It covers every web 
development subject under the 


Traversy Web Development _| stztetercattee 

















Brad If you like to learn web technologies such as Docker, GETTING STARTED 
Traversy development by watching Python (including Python Flask WITH THE WEB 
YouTube, then Brad Traversy for web app development), Getting started with the Web 
see has one of the biggest channels WordPress theme development, is a series of tutorials from 
around. There are videos on all and even general subjects such Mozilla that covers HTML, CSS, 
eect ones the main subjects, including as career and personal help. One and (as the name suggests) all 
crash courses in HTML, CSS, video, titled ‘Overwhelmed with the basics. It's a clean guide 
and JavaScript. Plus detailed web development technology’, to getting started and a great 
videos on various stacks (such seems apt. resource to bookmark. 
as React & Django and MERN). There is a lot to digest here, magpi.cc/ 
And there are web servers and and it’s all free to watch and mozillagettingstarted 
database technologies. If that’s generally enjoyable to sit 
not enough, Brad goes into other _ through. Although interactive COURSERA 
courses offer a greater learning Another free offering with 
experience than YouTube video, certification. Coursera 
Traversy Media so it’s good to combine this has a wide range of web 
ni Fe a resource with a tutorial or book. development courses offered 
Brad offers a range of Udemy by universities. University of 
courses to sign up for on his Michigan's ‘Web Design for 
website (traversymedia.com). Everybody’ and Johns Hopkins 
These courses offer more detail University's ‘HTML, CSS, and 
than the YouTube videos, and JavaScript’ are highly rated. 
you can learn as you work magpi.cc/coursera 





through the projects. H 
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P Ellora manages her 
YouTube channel 
mostly by herself, 
which can be a lot 
of work 


V_ Our favourite pie and 
microcomputer in 
one shot 
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Ellora James 


Meet the smart young computer scientist behind an 


exciting new YouTube channel 





> Name ElloraJames_ | 


> Community role YouTuber | 


hen did you have that 
W ‘ah-hah’ moment 

with computing? 
Ellora James remembers when 
she had hers. 

“When I was about 14/15 years 
old, I was considering taking 
Computer Science at exam 
level, and so my teacher gave 
me a Raspberry Pi to borrow 
and a booklet on Python to play 
about with,” Ellora tells us. “I 
remember taking it all home, 
setting up Raspberry Pi on my 
kitchen table, and writing my 
first-ever line of python where 
I got it to print ‘Hello World’. 





> Occupation Student 


> URL magpi.cc/ellora 


I was just fascinated by the 
concept of being able to get 
computers to do what we tell 
them, and I’ve been hooked 
ever since.” 

Several years, one company, 
and many awards later, Ellora 
is an up-and-coming young 
computer scientist who has 
recently launched her own 
amazing YouTube channel. 





What is your history with 
Raspberry Pi? 

I continued to work through 
the Python booklet at home 
and started to dive deeper into 


Raspberry Pi itself. The big thing 
that really cemented my love of 
Raspberry Pi was being selected 
to attend the Raspberry Pi Digital 
Making Day in Cambridge, 

back in 2016. We had to create 

a 60-second video to apply and 
despite mine, from what I can 
remember, being very cheesy, | 
was selected to attend. Me and 
my Mum travelled to Cambridge, 
which was a fun trip in itself. 

We tried soldering, set up bird- 
boxes with infrared cameras and 
Raspberry Pi Zero, and got to use 
electric paint to create circuits 
on T-shirts. It was so much fun, 
and I’m still planning on setting 
up my bird-box one day. Being 
specifically selected to attend 
gave me a lot of motivation to 
keep making. And that must 
have stayed with me over the 
years, as I’m back making again, 
and this time on an even bigger 
scale with my channel! 








What is Envirocache? 
Envirocache is a mobile app 
designed to get children (and 
adults) outside, active, and 
educated about the world around 
them. The app allows you to 





A Ellora's new YouTube 
channel includes fun 
builds with Raspberry Pi 


search for walking routes near 
you and shows you points of 
interest you can find along the 
way. You unlock badges and 
earn points for finding these, 
like a nature treasure hunt. The 
concept started off as an entry to 


from that project, and being my 
first big one it definitely holds a 
special place in my heart. It had 
a full user interface, let me pick 
from multiple songs, and even 
tweeted the time it took me to 
get up and turn it off in an effort 


fM The concept started off as dn entry 
to the Apps for Good competition @ 


the Apps for Good competition 
and has grown from there. I 
now work on the app alongside 
my team members, Mari-Ann 
Ganson and Jamie Smith. The 
app is still in its development 
stage, but we’re looking at a 
potential release date this year. 


What are some of your 
favourite things you’ve made 
with Raspberry Pi? 

My first big project was my 
‘PiAlarm’. I got a touchscreen 
display for the Raspberry Pi for 
Christmas back in 2015, and 
ended up designing an alarm 
clock in Python. It took many 
hours of work and I also lost my 
code at one point and had to 
start again, but I learned a lot 


to encourage me to get out of bed 
quicker. I actually made a short 
video about it and still have the 
code somewhere, so I’m thinking 
of revisiting it on my channel 

as a future project. I also took 
part in the 2016/17 European 
Astro Pi Challenge, where my 
project idea involved measuring 
environmental data on the ISS 

to see how this impacted the 
circadian rhythms of astronauts. 
The idea was that the astronauts 
would log how long they slept 

for, the quality of their sleep, 
and also hunger levels, to gain an 
understanding of their circadian 
rhythm. | also planned to create 
a reaction game to test how sleep 
and hunger levels affected their 
reaction times. 
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A The Grow HAT 
is part of a plant 
automation video 


One of Ellora's first 
projects was the 
PiAlarm. A simple 
but important build 
for her 
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This Month in 
Raspberry Pl 





I-suke the robot 


This amazing robot, developed by a 
young maker, helps greet people 


contest for young makers organised by the 

PCN (Programming Club Network). PCN 
helps kids learn to code, so in some ways it’s 
similar to CoderDojo and its Coolest Projects. 

This year’s winner, Rito Takahashi, created 
Al-suke (I-sue-kay), a robot that uses facial 
recognition to greet people at the door. Ina time 
when people are staying at home, it helps to 
avoid unnecessary contact. 

“T named the robot Al-suke, which means 
‘Al help’,” Rito tells us. “Al-suke has a built- 
in camera and speaker, and faces and voice 
messages are registered in advance. Al-suke 
can do face recognition to identify the person 
who visits the house, and play a voice message 
tailored to that person.” 

It will also send notifications to LINE, a 
smartphone instant messaging service, so you 
can know if someone has arrived while you’re 


[ n Japan, there’s a yearly programming 


/ , A A\l-suke sits outside, 
out of the house. bs? waiting for guests 
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Al-suke has a ‘face’, as well as other humanoid 
features, which gets people to look at it. 

This, in turn, means their face can actually be 
seen by the camera. 

“The people talking to Al-suke feel calm and 
happy because of its cute voice and appearance,” 
Rito says. “My five-year-old brother acted as the 
voice actor. The cute body is made with cardboard 
and wire. These give people a warm impression, as 
well as ease the anxiety.” 

You can view a video of Al-suke in action here: 
magpi.cc/aisuke. It’s in Japanese, but you'll get 
the idea. 

What does the future hold for this young maker? 

“T would like to make things that are not only 
useful for people, but also make people happy. 
Raspberry Pi has many powerful functions, so I will 
try them to improve my future work.” 





Notifications, with a photo, are sent to 
the user's phone via LINE 


Visitors see Al-suke and look at it. An 
automated, pre-recorded response is 
played depending on who is there 
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MagP1 Monday 


Amazing projects direct from our Twitter! 


very Monday we ask the question: have you 
made something with a Raspberry Pi over 
the weekend? Every Monday, our followers 
send us amazing photos and videos of the things 
they’ve made. 
Here’s a selection of some of the awesome things 
we got sent this month - and remember to follow 
along at the hashtag #MagPiMonday! 





2 Michael (Mike) Horne 


Gosh yes - epic week off and great weekend. Been 
working on my PicoPicorder project. 

Full write-up of the Raspberry Pi Pico-based project 
here: recant 


0.uk/blog/?page_id-=... :-) 















= 02 


This by the front door so | know if | need a coat. Area 
4 weather data comes from a JSON feed, and hyper-local 
readings from a sensor in the back garden ona 
Raspberry Pi Zero. All collated by another Raspberry Pi 
Zero in the house and output to an e-ink panel. 

sr ee 























O1. We like the little LCARS-inspired Ul on 
the screen here 

02. E-Ink panels always looks very clean. 
This UI really works well 

03. Dr Footleg continues to make cool 
videos with his LED matrices 

04. These sensors look very swish 

05. We love these kinds of life simulators. 
They always look cool 

06. Avery fun concept. once again with 
e-Ink displays 

07. The biscuit thief has been caught red- 
handed/jumpered 

08. These pictures are stunning from 
RUHACam 

09. This dithering method is spectacular! 

D ox 


| spent some time coding for PiMowBot project and 
Tim did an awesome job & designed new #3Dprint 
cases for a NeoPixel ring CO2 traffic light. Code 
@aithub,. New 3D models @Cults3D. 


#MINT #1OT #CO2Ampel #3dprinting #Maker 
#esp8 


SCD40 #MHZ1% 


266 #KISS #RaspberryPi # 








| 








Dr Footleg - Roboteer 


tleg 


| soldered up the first PCB from my latest KiCAD design 
An LED Matrix driver for the Pi. #MagPiMonday 


@ dr Footieg - Roboteer ur \ 
Couldn't end the weekend without testing my new #PCB design! It works! 


















9 Mike Fell 


Here is v1 of my universal analog meter with eink 
display that can be set to any scale (here for example 
renewable elec on GB grid and moon phase). Parts: 





@Raspberry_Pi zero, @waveshareO0 display, 
@Meccano gears. I'll put a video of it in action in the 
reply 








: 9 to 


Finished off an interactive simulator of evolution and 
ageing! Mutant spread visualised on a panel of LEDs, 
buttons to introduce mutations. Runs on pi and pico! 











Simulating and visualising cell competition in ageing tissues! 
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Crowd{fund this! 


Raspberry Pi projects you 











e-= can crowdfund this month 
Yorks STEAM 07 

Rept > TTheMagh) 

This ‘choc bics thief’ guy is not getting the biscuit 
today. #raspberrypipico #MagPiMonday 









USB RTC 


allow user to measure passage of time 





















USB RTC for. 
Raspberry Pi 
We open sourced the 3D printable retro-style Pi HQ 


camera, #RUHACam, and took it out for a spin in Tokyo Asimpler way to add a real-time clock to a Raspberry Pi 
- using USB! It has a low-power DS3231 RTC chipset and 
makes use of UART for connecting over USB. It's already 
been funded at the time of writing, so worth a look. 





© al EJ 
Replying to @Ti G 


heMag? 





ruha.camera 


» kck.st/39zGWDx 























ePaper Photo Frame - writeup in progress ... 

It's impressive how much detail can be achieved with a 
tri-color display with an algorithm from 1976 - 
#FloydSteinbergDithering 


And yes - that’s a tri-color ePaper Display - Red, White 
and Black! 


#MagPiMonday 





LumiCube 





“We think of the LumiCube as the ultimate Raspberry 

Pi kit. Perfect for beginners and enthusiasts alike. It 
takes the Raspberry Pi, a powerful mini computer, 

and combines it with a whole range of electronics and 
sensors, from a speaker to an accelerometer, allina 
10cm cube - the perfect playground for your creations." 











» kck.st/3IkBitv 
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Pi Day donors 


You helped out the Raspberry Pi Fo 


undation 


with donations in March. Here's how it went 


American notation, 14 March is 3/14, 


0 n 14 March, we celebrate Pi Day. In 


which is the same 


as the first three digits 


of the mathematical constant, pi. No emails 
about tau, please. To celebrate its namesake this 
year, the Raspberry Pi Foundation had a special 


fundraising campaign. 


“When people think about Raspberry Pi, they 
usually think about the tiny, affordable, and 


powerful computers we a 


1 know and love,” 


says Anna Coe, Senior Development Manager 
at the Raspberry Pi Foundation North America. 


“What many don’t know 
Foundation is a non-profi 


educational mission. That 


is that the Raspberry Pi 


t organisation with an 
mission is to put the 








power of computing and d 








igital making into the 


hands of people all over the world.” 
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a 


There was a special little bonus for people who 
donated — their name mentioned here in The MagPi. 

“Tn the weeks leading up to Pi Day, over 400 
generous individuals and companies contributed 
more than £18,000 to support young learners who 
rely on the Raspberry Pi Foundation’s free learning 


M Over 400 generous 
individuals and companies 
showed their support @ 


resources,” Anna reveals. “Through gifts of $3.14, 
£31.42, €314.16, and more, Pi Day campaign donors 
have made an impact on 60,000 young digital 
makers who are learning new skills and getting 
creative with computing.” 

We’re honoured to display all your names. Thank 
you for funding the Raspberry Pi Foundation. 








Special thanks 
from Raspberry Pi 





The Raspberry Pi Foundation extends 
deep gratitude to the Pi Day campaign 
donors listed here, and to the additional 
220 supporters who have chosen to remain 
anonymous. Special thanks goes to EPAM 
Systems. who matched the first $5000 
raised dollar-for-dollar; to Canakit for 

their generous gift of $3141; and to OKdo 
for donating 50% of their Pi Day weekend 
proceeds to this campaign. 


If you would like to learn how you or your 
company can support the Raspberry 

Pi Foundation’s mission, please visit 
raspberrypi.org/support-us. 
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Letters 


Free GCSE lessons 


I noticed that the Isaac Computer Science website only currently 
does A levels. Could you recommend any other online learning 
sites, preferably free ones, that do a similar thing but with GCSEs? 
Are there any lesson plans on the projects website? 


Kat vid email 


Good news: the Raspberry Pi Foundation has decided to expand the 
scope of the Isaac Computer Science platform to add GCSE content, 
thanks to a huge demand from teachers. Like the A level lessons, it 
A The Beginner's Guide is packed full of all the info you need for getting will be available around the world, although tailored to the English 
started with Raspberry Pi curriculum. It should be launching early next year, and you can read 


more about it here: magpi.cc/isaacgcse. 
Binary to objects 


I just got a Raspberry Pi. It’s just like starting over for 
me; I like working in ones and zeroes and hexadecimal 
as I used to work on an Apple II. , 
Are there any good articles out there to help me ’ ‘ - 
convert from Apple II thinking to Raspberry Pi? 2 











WY The current A level content is free and available to everyone 


Donald via email 


Unfortunately, we’ve not come across any one-to-one 
articles about going from Apple DOS to Raspberry Pi 

OS, or even coding in binary to Python. However, we 
think that The Official Raspberry Pi Beginner’s Guide book 
(magpi.cc/bguide4) is a great way to start with Raspberry 
Pi, and should help you translate your skills. 
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YV The software looks a lot like Scratch and other block-based coding 
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Scratch for Pico 


I like using Scratch on Raspberry Pi to make programs. However, it 
doesn’t seem to be available for Pico yet. Do you know if there will 
be a Scratch update soon that works with Pico? I think it would be 
really popular. 





Ten via Facebook 


While Scratch doesn’t work with Raspberry Pi Pico yet, there is an 
alternative we can recommend called Piper Make. You can find it 
at make.playpiper.com and it’s a free block-based programming 
language like Scratch. You can control circuits and sensors and 
such using the tools in Piper Make. And like other Piper stuff, it 
gives you challenges to complete, so you can learn and have fun at 
the same time. 
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A lt requires a few wires and some special software, but it works 


Pico networking 


I got a Pico when it first came out, thanks to 
HackSpace magazine, and have been tinkering with it 
since, trying out examples from the books and such. 
One thing I’d like to do, though, is to add a wired 
connection to it. I’ve got a few gizmos to add WiFi, 
but there are certain places in my house that do not 
have a great wireless signal. Any ideas? 





Jeegar vid GitHub 


You’re in luck! While there’s not a simple plug-and- 
play style solution, you can absolutely add an Ethernet 
port with some specific components, code, and wiring. 
Alasdair Allan, from Raspberry Pi, recently wrote up a 
blog on it, complete with a guide on how to get it working 
yourself. Check it out here: magpi.cc/picoeth. 


Contact us! 


> Twitter @TheMagPi 


> Facebook magpi.cc/facebook 


> Email 
> Online 


magpi@raspberrypi.com 
raspberrypi.org/forums 
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APEKEONE OF SA 


4.01 ACEP 
¢-COLOUR E-PAPER 
DISPLAY HATS! 


IN ASSOCIATION 
WITH @:PiHut 


Ulltdd 








Colour e-paper enables the creation of 
low-power, simple multicolour displays 
that look different and cool. This HAT has | 
a 640x400 seven-colour display and fits 
neatly atop a full-size Raspberry Pi. | 


7-Color ACeP 
Display 





Head here to enter: magpi.cc/win | Learn more: magpi.cc/acepepaper 





Terms & Conditions 

Competition opens on 28 April 2021 and closes on 27 May 2021. Prize is offered to participants worldwide aged 13 or over, except employees of the Raspberry Pi Foundation, the 
prize supplier, their families, or friends. Winners will be notified by email no more than 30 days after the competition closes. By entering the competition, the winner consents to any 
publicity generated from the competition, in print and online. Participants agree to receive occasional newsletters from The MagPi magazine. We don't like spam: participants’ details 
will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and no cash alternative will be offered. Winners will be contacted by email to arrange 
delivery. Any winners who have not responded 60 days after the initial email is sent will have their prize revoked. This promotion is in no way sponsored, endorsed or administered by, 
or associated with, Instagram or Facebook. 
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A smart investment 


Fantastic tales from the fourth dimension, featuring Rob Zwetsloot 


feature from PJ Evans, a 

regular here at The MagPi, 
about home automation. As 
summer hurtles towards us with the 
momentum of a runaway freight 
train, you might be wondering if 
now is the right time to actually get 
stuck in with upgrading your home. 

I’m here to tell you that now is the 
perfect time. As long as you have 
some time. 

When we’re out enjoying the 
parks and beaches and pub gardens, 
who will be left at home to feed the 
cat? Who will water your plants? 
Who will brew your artisanal latte? 
Certainly not the cat. So why not 


| ast month we had a fantastic 


M As the saying goes, 
‘the time you enjoy 
wasting is not 
wasted time’ @ 
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invest your time now so that you can 
have a bit more time when it really 
matters? Go find your copy of issue 
104 of The MagPi, and have a look 
through the feature for some ideas 
and inspiration. 


Wasted time 

As the saying goes, ‘the time you 
enjoy wasting is not wasted time’. 
And sometimes taking the extra time 
to set up a system to do a job feels 
like you’re spending as much time as 
you might be saving. This is where we 
like to come in with fun ways to make 
with Raspberry Pi, and great stories to 
inspire you to dream big and maybe 
do something a bit different. 

Maybe this is your excuse to get 
plants that need watering. Or to get 
into really nice coffee. Definitely not 
acat, though: they’re no fun. You 
might discover a fun new hobby, a 
new way to code, or at the very least, 
you might have a fun story to tell 
later on. 














Nothing is forever 
I have been there with the whole 
investing time for the future thing 
when it comes to making, so I do 
have some advice: build in some 
redundancies, make backups, write 
notes, and basically make sure that 
if something inevitably breaks, you 
can fix it. Of course, this may take 
more time, but it will save time in 
the future. Hopefully this won’t 
happen while you’ re off enjoying 
your summer, though. Might 
overfeed the cat. 

So go forth. Invest your time, have 
some fun, and then enjoy the sweet, 
sweet fruits of your labours. Hl 





Rob Zwetsloot 





Rob is amazing. He's also the Features 
Editor of The MagPi, a hobbyist maker, 
cosplayer, comic book writer, and 
extremely modest. 
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APPROVED RESELLER 


Prom Coltm Ciel 





Buy in the USA: 


PiShop.us/stereopi 


Buy in Canada: 
BuyaPi.ca/stereopi 


LinuxGizmos.com 

“The StereoPi can capture, save, 
livestream, and process real-time 
stereoscopic video and images for 
robotics, AR/VR, computer vision, drone 
instrumentation, and panoramic video.” 


RASPBERRY PI INSIDE 


MickMake 

“With it you can do things like, stream 
stereoscopic 3D video to YouTube, build 
real-time depth maps using OpenCV, 
create panoramics using Hugin and even 
a 3rd person view of real life. Cool.” 


Elettronica In Sat @LinuxGizmos.com 


hed 40] - 107 BB) 5 


StereoPi is an open source stereoscopic 
camera, based on Raspberry Pi. 


This is the friendliest way to play with 
the stereoscopic vision for the spatially 
aware robots, 3D photo and video! 


so Fe } 


STOCK RASPBIAN OPEN SOURCE CROWDFUNDED 
SUPPORT PROJECT 


Raspberry Pi Blog Hackster News 

“There are some excellent “You can hook this up to YouTube, 
community efforts too, of to Oculus Go, you can use it with 
which our current OpenCV.. | cannot wait to start 
favourite is this nifty dual messing around with these because 
camera board.” it’s basically a dream come true.” 
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